Talk:SDK Docs

From Valve Developer Community
Jump to: navigation, search
English (en)Svenska (sv)
Icon-message-48px.png
This is the discussion page of SDK Docs. To add a comment, use the Edit button near the headline of the appropriate section. To create a new section, you can use the Add topic button at the top of this page.
Comments on talk pages should be signed with "~~~~", which will be converted into your signature and a timestamp.

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)

New design

I've been testing the new design in my sandbox. It's not finished as I don't work with VDC very often now, but I still wanted to offer a new look.

Source SDK documentation page redesign.jpg

Pros

  • There is now quick access to Source Engine branches and their SDKs.
Note.pngNote:Not that it's useful, but when I needed it, I couldn't find the tool I needed quickly because someone didn't even bother to create a redirect from Source SDK Base 2013 to Source SDK 2013 🗿
  • Now games don't hide from you. Documentation of their tools is right on the Source SDK page.
Note.pngNote:The level design page with a link to the games now doesn't always link to the level design (for example, Team Fortress 2/Docs), and you have to do more unnecessary actions to reach the game tools page.
  • The colors and larger content size will help you find the right link faster.
  • The new design should look better on mobile devices (well, if rewritten).

Cons

  • My design offers a larger view of the links, which forces you to scroll down the page to reach certain links.
Note.pngNote:I don't think it's a problem because it's easier to identify links. Spending time on scrolling is much less than trying to find a certain link among a bunch of other links in a row.

--THE OWL (talk) 22:00, 3 November 2024 (PST)

New design is not needed. The current one works perfectly fine and I don't have to scroll to see all links. One thing from it that would be good to do is adding the links to individual game doc pages but not with such overly huge boxes --Nescius (talk) 07:12, 4 November 2024 (PST)
I'll try to do something about it later.
THE OWL (talk)