Difference between revisions of "Talk:SDK Docs"

From Valve Developer Community
Jump to: navigation, search
(Restructuring the category pages)
(Reverted vandalism)
 
(146 intermediate revisions by 14 users not shown)
Line 1: Line 1:
<div style="float:right; margin-top: 20px; width: 250px; background:#F0F0F0; border: none; padding: 0.5em">
+
{{menubox
==Archives==
+
|title=Archives
Please '''do not''' edit the archives
+
|link=Talk:SDK Docs
* [http://developer.valvesoftware.com/w/index.php?title=Talk:SDK_Docs&oldid=92470 28 June 2005 to 4 Aug 2008]
+
|text=*[http://developer.valvesoftware.com/w/index.php?title=Talk:SDK_Docs&oldid=109619 August 4 2008]<br />
</div>{{clr}}
+
* [http://developer.valvesoftware.com/w/index.php?title=Talk:SDK_Docs&oldid=116470 April 30 2009]<br />
 +
* [http://developer.valvesoftware.com/w/index.php?title=Talk:SDK_Docs&oldid=163196 December 05 2011]
 +
}}__TOC__
 
<!-- Please start new discussions below this line. -->
 
<!-- Please start new discussions below this line. -->
 +
== Shortname or longname ==
 +
Compare this [[Template:KV_RenderFields]] and this [[Template:KV_Shadow]] and this [[Template:I_RenderFields]]. As you can see, sometimes it's "bool"/"int" but sometimes "boolean"/"integer". What will be better to use? --[[User:Mehiller|Mehiller]] 21:54, 2 May 2012 (PDT)
 +
:In my opinion, "boolean" and "integer" is friendlier for non-programmers, though I would prefer the shorthand versions. That's just me. &mdash;[[User:Mattshu|Mattshu]] 23:11, 11 July 2012 (PDT)
  
== Restructuring the category pages ==
+
== SFM link ==
I would like to restructure the categories section from their current implementation for what I believe would be easier navigation.  My two suggested changes are stated below. --[[User:Brandished|brandished]] 05:24, 27 March 2009 (UTC)
 
  
=== 1. Over-categorization ===
+
The link at the Source page for the [[Source Filmmaker]] leads to a Category page. Which isn't supposed to happen. Can you guys fix it? --[[User:017Bluefield|017Bluefield]] 23:39, 10 July 2012 (PDT)
I feel many of the categories, such as entities and level design are covering a topic ranges a bit too broad to be useful to most users. I'd like to restructure according to these guidelines from [http://en.wikipedia.org/wiki/Wikipedia:Categories,_lists,_and_series_boxes Wikipedia]:
+
:I'm thinking that was intentional. &mdash;[[User:Mattshu|Mattshu]] 23:56, 10 July 2012 (PDT)
: ''An article will often be in several categories. Restraint should be used, however — categories become less effective the more there are on a given article.''
+
::Uh-huh… Did you check the history yet? Any edit—even the vandalism type—gets recorded their, right? --[[User:017Bluefield|017Bluefield]] 00:13, 11 July 2012 (PDT)
: ''An article should usually not be in both a category and its subcategory, e.g. Microsoft Office is in Category:Microsoft software, so should not also be in Category:Software—except when the article defines a category as well as being in a higher category, e.g. Ohio is in both Category:U.S. states and Category:Ohio''
+
:::Yes. You're referring to the link on [[SDK Docs]], right? &mdash;[[User:Mattshu|Mattshu]] 00:16, 11 July 2012 (PDT)
 
+
::::Yeah. I remember checking it yesterday, but it must've slipped my mind today. --[[User:017Bluefield|017Bluefield]] 12:42, 11 July 2012 (PDT)
For an example, a category I feel would benefit from this is [[:Category: entities]].  I would like to remove articles related to specific entities from the parent category entities and place them only in subcategories instead.  My arguments for this are:
+
::::Nevermind. It's someone named Dmx6 who did the edit. --[[User:017Bluefield|017Bluefield]] 12:45, 11 July 2012 (PDT)
# There is no clear delimiters as to which game engine, game, or mod certain entities are available for. Many of the articles listed in the main category will be of little to no use to users who don't own those specific games
+
:::::{{user|Dmx6}} is a regular, trusted contributor to the wiki. It is linked to the category page because it contains many resources for using SMF. Sorry, but I'm not sure where you're seeing the vandalism. &mdash;[[User:Mattshu|Mattshu]] 22:42, 11 July 2012 (PDT)
# The current tags groups many mostly unrelated articles together.
 
: --[[User:Brandished|brandished]] 05:24, 27 March 2009 (UTC)
 
 
 
=== 2. Splitting apart category pages from entry pages ===
 
Many of the large category pages, such as [[Category: Level Design]], I believe have become too overloaded with content to be easily used as WiKi categories.  Many of the categories with these problems are linked directly to the "SDK Docs" page.  The actual categorized pages are being over looked and unused by many due to having to scroll to the very bottom of the most of the linked pages to see the actual categorized pages with their current set-up.  This problem is compounded if an article in the category is not located within the first 200 results, after clicking next users are forced to scroll through all the contents again to get to the categorized pages. To be clear, I'm not saying get rid of the Category pages, but just moving the table-of-contents parts into regular articles.
 
 
 
For example, the lower half of [[:Category: Level Design]], starting from "Subcategories" and below, would remain along with the categorized pages, but table of contents portion above that would be moved outside of the category into an article page.
 
eg, instead of the main page being located at:
 
[[:category:Level Design|Level Design]]
 
 
 
the new location for the table-of-contents parts would be:
 
[[Level Design]]
 
 
 
With a link at the top of the category page something like:
 
:''The main article for this category is [[Level Design]]''
 
: --[[User:Brandished|brandished]] 05:24, 27 March 2009 (UTC)
 

Latest revision as of 03:41, 21 March 2019

Shortname or longname

Compare this Template:KV_RenderFields and this Template:KV_Shadow and this Template:I_RenderFields. As you can see, sometimes it's "bool"/"int" but sometimes "boolean"/"integer". What will be better to use? --Mehiller 21:54, 2 May 2012 (PDT)

In my opinion, "boolean" and "integer" is friendlier for non-programmers, though I would prefer the shorthand versions. That's just me. —Mattshu 23:11, 11 July 2012 (PDT)

SFM link

The link at the Source page for the Source Filmmaker leads to a Category page. Which isn't supposed to happen. Can you guys fix it? --017Bluefield 23:39, 10 July 2012 (PDT)

I'm thinking that was intentional. —Mattshu 23:56, 10 July 2012 (PDT)
Uh-huh… Did you check the history yet? Any edit—even the vandalism type—gets recorded their, right? --017Bluefield 00:13, 11 July 2012 (PDT)
Yes. You're referring to the link on SDK Docs, right? —Mattshu 00:16, 11 July 2012 (PDT)
Yeah. I remember checking it yesterday, but it must've slipped my mind today. --017Bluefield 12:42, 11 July 2012 (PDT)
Nevermind. It's someone named Dmx6 who did the edit. --017Bluefield 12:45, 11 July 2012 (PDT)
Dmx6 is a regular, trusted contributor to the wiki. It is linked to the category page because it contains many resources for using SMF. Sorry, but I'm not sure where you're seeing the vandalism. —Mattshu 22:42, 11 July 2012 (PDT)