Difference between revisions of "Help talk:Editing"

From Valve Developer Community
Jump to: navigation, search
(Is this a minor edit or major edit?: new section)
(Glad we all did this democratically. Since no one objects, it shall happen soon. ~~~~)
 
(26 intermediate revisions by 8 users not shown)
Line 1: Line 1:
Is there any way to make new pages? I've got a bunch of tutorials and other stuff on Steam that could be with being added.
+
{{menubox
:I think you just need to modify the url in your address bar to go where you'd like. If I wanted to start a page on "stuff", I'd use the address http://developer.valvesoftware.com/wiki/Stuff . No doubt there is an easier way, but there are some significant differences between the SDK wiki and other wikis like Wikipedia. [[User:Geogriffith]]
+
|title=Archives
::Clear and simple information on how to create new pages should be added here. This is one of the most common things that people have trouble with. --[[User:JeffLane|JeffLane]] 01:27, 1 Jul 2005 (PDT)
+
|link=Help_talk:Editing
 +
|text=* [https://developer.valvesoftware.com/w/index.php?title=Help_talk:Editing&oldid=55811 11 Dec 2005]
 +
* [https://developer.valvesoftware.com/w/index.php?title=Help_talk:Editing&oldid=92371 29 Jun 2008]
 +
* [https://developer.valvesoftware.com/w/index.php?title=Help_talk:Editing&oldid=147366 29 Mar 2011]
 +
}}
 +
<!--- Please do not edit above this line --->
 +
To create a topic, [https://developer.valvesoftware.com/w/index.php?title=Help_talk:Editing&action=edit&section=new click here].
  
Does anyone know how to add pictures? [[User:Fiercefighter|True_Unity]] 08:26, 11 Dec 2005 (PST)]
+
== Page size ==
 +
This page is large. Probably should be split into smaller, more digestible topics. It's almost doubled in length. --[[User:JeffLane|JeffLane]] 16:30, 29 December 2011 (PST)
 +
:Actually before I did the makeover, I thought about partitioning the page into several other 'sub-pages', maybe only putting the table of contents box on [[Help:Editing]], then create [[Help:Editing/Page_Creation]], [[Help:Editing/Editing_Toolbar]], etc with their own information. I didn't do it because I didn't want to change the layout TOO much at once. &mdash;[[User:Mattshu|Mattshu]] 17:01, 29 December 2011 (PST)
 +
:: It would seem to make sense to start with retaining the basic page creation and syntax, and then link to pages containing all of the specialized notice and entity templates. --[[User:JeffLane|JeffLane]] 18:08, 29 December 2011 (PST)
 +
:::How's it look now? &mdash;[[User:Mattshu|Mattshu]] 18:42, 29 December 2011 (PST)
 +
::::Definitely an improvement. --[[User:JeffLane|JeffLane]] 12:17, 30 December 2011 (PST)
 +
::I'm thinking about making this similar to Mattshu's idea because this still is a really long page that I doubt people will read in full. Any thoughts? [[User:Pinsplash|Pinsplash]] ([[User talk:Pinsplash|talk]]) 18:42, 15 July 2018 (UTC)
 +
:::No thoughts? Bumping. [[User:Pinsplash|Pinsplash]] ([[User talk:Pinsplash|talk]]) 16:30, 17 July 2018 (UTC)
 +
::::Glad we all did this democratically. Since no one objects, it shall happen soon. [[User:Pinsplash|Pinsplash]] ([[User talk:Pinsplash|talk]]) 03:42, 20 July 2018 (UTC)
  
<<You see that link over yonder that says Upload file? Push it&mdash;'''[[User:Ts2do|ts2do]]'''&nbsp;<sup>([[User talk:Ts2do|Talk]]&nbsp;|&nbsp;[mailto:[email protected] @])</sup> 11:43, 11 Dec 2005 (PST)
+
== Renaming pages ==
  
== Additions ==
+
Is there a way to rename a page that has already been made? For example, I want to make a page for the 2014 standalone game Insurgency, but the original HL2 mod (a different version of the game) already has a page called Insurgency. I want to rename the mod page to something like "Insurgency (Mod)" so that a new page can be made called Insurgency. Is there a way to rename a page?
  
Added bullet points. I noticed someone added something about redirects. 6-28-05 [[User:Geogriffith]]
+
[[User:Greenhourglass|Greenhourglass]] ([[User talk:Greenhourglass|talk]]) 00:52, 8 December 2016 (UTC)
 +
:There is a move page feature. I'm not sure if it's restricted or not, but it's there. If you click the arrow next to the add to watchlist button (the star, up at the top bar, next to edit) there will be an option called ''move'' or similiar. - [[User:Dr. Orange|Dr. Orange]] ([[User talk:Dr. Orange|talk]]) 15:19, 8 December 2016 (UTC)
  
Added some more info about math symbols, equation rendering. Looks like it's not enabled though because I can't get it to work, am I doing something wrong? -- [[User:MrAnderson|MrAnderson]] 13:55, 4 Jul 2005 (PDT)
+
== create a lobby-bot ==
  
 +
Hi at all,
  
== Code tags ==
+
I want to code a program in python, which open a lobby for a Dota2 match
 +
on their servers and afterwards invite steam members to this lobby.
 +
I have already installed and imported the modules steam and dota2-0.2.6
 +
but get confused by the mass of methods and their interactions.
 +
Is it possible with those modules and when yes, how?
  
(This discussion originated on the [[Talk:areaportal]] page, and was moved here.)
+
thanks {{Unsigned|‎Cyberfischer}}
 
+
: This probably isn't the right place for this particular question. Also, remember to sign your comments on talk pages with four tilde signs (<nowiki>~~~~</nowiki>) which will automaticly insert your signature and date. -- [[User:Dr._Orange|<span style="color: #ffaa00">Dr. Orange</span>]] <sup>[[User_talk:Dr._Orange|talk]] · [[Special:Contributions/Dr._Orange|contributions]]</sup> 17:40, 13 January 2017 (UTC)
I am pleasantly surprised that you (Jeff) put so much effort into it with pictures and all. From being just a footnote mentioned as parts of several bloated articles, areaportals now have a beautiful "home". However, as uncomforting it is telling ''you'' this, the entity <nowiki><code></nowiki> format you used was scrapped years ago. (It looks ugly and distracting, and confusions over "light" entities has been unheard of.) Do you mind if I remove the code tags? --[[User:Andreasen|Andreasen]] 10:37, 20 Sep 2007 (PDT)
 
:I mind. I think it has been established as part of this wiki style to code-tag entity names amongst others. --[[User:Tourorist|Tourorist]] 13:03, 20 Sep 2007 (PDT)
 
::Uh, name five articles that still has the code tag (that isn't 1-2 years old). --[[User:Andreasen|Andreasen]] 13:45, 20 Sep 2007 (PDT)
 
:::There was some discussion of this last year, but it was not conclusive enough to merit changes as the reasons given were completely subjective and there was no consensus. The [[Help:Editing#Formatting_guidelines]] page reflects the closest guide to current usage, as well as a number of existing articles on the site that use the tags in this way. The age of the articles is also not very relevant. In fact, it's the opposite if most of them are using this format and there was no consensus on a change. In the case of this article, I actually got most of this formatting when I moved sections from the original [[Controlling Geometry Visibility and Compile Times]] page.
 
 
 
:::That said, I don't feel that strongly about this either way, so if a significant number of editors come to a consensus and want to change it in some way, that's fine. Though I do feel that entity names really need some '''visible marking''' to show that they are not just English nouns. They are keywords with significance and are almost always the focus of the text. It's the same reason we highlight other keywords like '''Menu Titles'''. Why would it be any different? There are precedents in technical documentation for this. Capitalization is often used for important keywords, but that would just be confusing in this case. Another other option is bolding, which might work better. Hope that helps. --[[User:JeffLane|JeffLane]] 18:52, 20 Sep 2007 (PDT)
 
 
 
 
 
::::I tried to find the previous discussion we had about this, but couldn't find it.
 
::::I rarely see code tags being used in articles, so I don't think that the [[Help:Editing]] page ''is'' reflecting the current usage. I've seen only three pages that uses the tag for entities as of late: [[Controlling Geometry Visibility and Compile Times]], [[areaportal]] (this page), and the one that [[User:Tourorist]] "codified" himself, believing that the tag was current usage.
 
::::The reason for this is natural: Besides being an unnecessary eyesore to readers, "<nowiki><code>[[entity]]</code></nowiki>" also takes twice the amount of characters to write (including special characters) than "<nowiki>[[entity]]</nowiki>", and entities are used much more commonly than console commands and file paths are.
 
 
 
::::As for special marking, many articles doesn't focus on a particular entity, but of a topic involving many entities, where they themselves are often just mentioned as mere alternatives, or even exceptions (like "[[Prop_physics]] should not be used for this."), drawing attention to totally different topics. As it is now, when entities are first mentioned, they are linked to (according to current guidelines) which is marking them in blue, and the topic is then understood. If need be, we could mark them all in blue, every time they're mentioned. That should be the closest natural markup for authors, and just looking at this very text, that markup should make all the entity names stand out, without drawing ''too'' much attention to it.
 
 
 
::::I can't argue with technical documentation standard, but judging by the article you just wrote, turning a matter-of-factly (technical) article into something a little more greeting and fleshed out, I don't think that the VDC is a 100% technical manual. Also, if compared to wikipedia, I don't see any technical lingo being marked up there.
 
 
 
::::Entities are rarely even able to be confused with nouns. Of all the entities (I checked the lists.) only four doesn't have an underscore (_) in them: [[Cycler]], [[gibshooter]], [[infodecal]], and [[light]]. There are two easy methods to deal with these:
 
::::# You can set the topic by linking to the entity article at its first mention (and if in any way unclear, later mentions as well), like above. The latter mentions of it is then obvious.
 
::::# You can refer to it as "the xxxx entity". The only entity that even comes close to being confused then, is the [[light]] entity, if someone would assume that the article was about weight instead of lighting, which would be virtually impossible to do, considering how different these topics are. When dealing with light entities as a category, one can refer to them as "light source entities" to avoid confusion.
 
 
 
:::: I wish there ''was'' a significant number of authors around to vote for ''any'' change, but considering that most articles currently use the lighter "<nowiki>[[]]</nowiki>" markup, that change would be ''back'' to using code tags. It's easier to remove the guideline than to change most of the articles in the wiki. One can't seem to find entity code tags through the search engine, but could I, I would gladly hunt down the last remaining code tags myself, if only allowed, because it makes every mention of them a bother. --[[User:Andreasen|Andreasen]] 06:48, 21 Sep 2007 (PDT)
 
 
 
::::: I wasn't the one who introduced this practice, if that's what you imply. And like Jeff, I am neither for nor against on this issue, my sole interest (as evident from my contributions) is in overall consistency of wiki, whichever way we go. --[[User:Tourorist|Tourorist]] 07:23, 21 Sep 2007 (PDT)
 
:::::: I'm not at all blaming you for following what you believed to be current standards. --[[User:Andreasen|Andreasen]] 08:34, 21 Sep 2007 (PDT)
 
 
 
::::: The VDC documentation is [[Wikipedia:technical writing|technical writing]], like any type of help files or user manuals are. Creating content with the Source Engine is a technical subject. It is from that perspective we try to evaluate these kinds of decisions.
 
 
 
::::: I would agree with a change if it's a positive one, or even an equal one, but I'm not convinced that removing all the entity formatting is positive. They are an important keyword, essentially a cross between a menu command and a piece of code (depending on the context), and their exact name is significant. Text formatting of some type needs to reflect that distinction when no link is present.
 
 
 
:::::The suggestion of standardizing formatting in blue is reasonable one, but would make them look like false page links, so it shouldn't be that, and adding color tags is prone to errors. Using '''bolding''' after the first link is a better alternative since it has simple wiki syntax. That would put them on the same level as menu titles and commands, which does make some sense from the perspective of most of our users. For them, picking entities is a menu choice in Hammer and the primary context they will see them (few of our users read the .fgd file, for example). ''Italics'' is another alternative, though they don't read particularly well in this typeface and point size, and readability is critical for entity names.
 
 
 
:::::As an aside, I've never been too happy about the extra gray shading behind the text in the code tags. It too dark on some monitors and lighter on others and the <tt>monospace typeface</tt> that shows up with code tags is really sufficient for the purpose. I will likely remove it in the site-wide CSS, no matter what we decide with entities. --[[User:JeffLane|JeffLane]] 11:16, 21 Sep 2007 (PDT)
 
 
 
:::::The gray background is now removed from <code>code tags</code>, and the space between section headings is now slightly increased (especially level 2 sections). --[[User:JeffLane|JeffLane]] 14:47, 21 Sep 2007 (PDT)
 
 
 
::::::When you wrote that the format had precedents in technical documentation, I assumed the highlighting in gray was some sort of technical manual standard that I must have never seen before, but [http://www.io.com/~hcexres/textbook/high.html this page] tells me it's pretty in the hands of the manual designer.
 
::::::Why would linking to them look like false page links? All entity pages has been written, so unless they are spelled wrong, they'll definitely be blue - not red.
 
::::::Although I prefer bolding over code tags, the users just see the entities in the plain, unformated text format and font, if that's what you mean. I've never seen entities as titles or commands - just plain names - but I can't speak that much for other users. I really wish more people would take part in this discussion.
 
::::::I don't see any changes in the CSS. I've tried updating the page. Perhaps I will have to delete the browser cache for the changes to take effect. --[[User:Andreasen|Andreasen]] 16:16, 21 Sep 2007 (PDT)
 
::::::: You likely just need to [[Wikipedia:Wikipedia:Bypass_your_cache|Bypass your browser cache]].
 
::::::: I misunderstood when you said "we could mark them all in blue", which suggested to me blue text formatting, not linking. Now I understand that you meant -- that entity names could be linked at all times. This seems like an excessive choice and is not common practice for hyperlinking (which is link on first mention, and not thereafter, though I think you know that). The link you provided seems to be targeted at technical writing for printed works, but still reinforces what I have been saying -- technical terms deserve special formatting/emphasis. I never said that gray shading was some type of standard, though I could see how you could have misunderstood my statement. I said visible marking of significant keywords has precedent in technical writing. Beyond that, the exact formatting is not as critical as long as it is consistent.
 
::::::: With the removal of the gray background shading, and short of any more overwhelmingly compelling discussion, this matter has received enough attention and I consider it resolved. Code tags can be used for entities in any new articles and added to existing ones incrementally. --[[User:JeffLane|JeffLane]] 15:42, 22 Sep 2007 (PDT)
 
::::::::Okay, now that my cache has finally been updated, the code tags are not quite as disturbing anymore, so I consider it an acceptable compromise. I'll start using them, though it'll be a lot of pages to change overtime.
 
::::::::Yes, linking to entities consistently would not have been common practice, but still more discreet than the grey highlighting.
 
::::::::The link I provided also seemed to stress not to overdo highlighting.
 
::::::::...but all's well now. Just a little difficult to write down, but at least it looks decent now. --[[User:Andreasen|Andreasen]] 16:20, 22 Sep 2007 (PDT)
 
 
 
::::::::Actually, especially looking at the plural forms (for instance "<code>[[path_track]]</code>s"), this is only ''half'' as ugly as gray highlighting, but that might just be my opinion. Users, feel free to add your input. --[[User:Andreasen|Andreasen]] 09:12, 23 Sep 2007 (PDT)
 
 
 
== Tutorial credit template & guidelines ==
 
 
 
I have asked Mark if I could port the tutorials from sdknuts to here, and he liked the idea,
 
I have started working on the port but I have a couple of questions/requests
 
* Is there a information template like eg [[template:note]], [[template:tip]] or [[template:warning]]?
 
* I think it would be nice if we had a template to give due credit (either to myself or) to the author of the article (eg Mark in this case)
 
:This could be eg [http://en.wikipedia.org/wiki/Template:Cc-by-sa-3.0 Template:Cc-by-sa-3.0]
 
:Do we have any templates like this on wiki?
 
* Copyright notice on screen shots for tutorials? Should we have a [[Template:Valve-Screenshot]] like eg [http://en.wikipedia.org/wiki/Template:Ubisoft-screenshot Template:Ubisoft-screenshot]?
 
* And lastly; guidelines to give due credit? --[[User:Plykkegaard|Peter [AGHL]]] 13:16, 7 Feb 2008 (PST)
 
::I don't think such template exists, but creating one might work nicely towards giving credit to the original author of the tutorial, particularly in cases where a tutorial is written somewhere '''outside''' the VDC and is then ported here (like Mark's SDKNuts tutorials). Tutorials strictly written "inside" the VDC don't really require this information, since you can easily check the ''history'' page and find out who created the tutorial.
 
::In general (not simply in tutorials), '''every''' uploaded image ''should'' follow the [[Valve_Developer_Community:Image_use_policy|image use policy]], which states that '''every''' image should be uploaded with copyright information (stating that it was either created by the user that's uploading it, or that it belongs to the public domain, or that it is under the GNU Free Documentation License, etc...). It is clear that most people don't follow these guidelines: for example there are ''loads'' of Valve games images that aren't clearly marked as such. However, creating a Valve version of the [http://en.wikipedia.org/wiki/Template:Ubisoft-screenshot Template:Ubisoft-screenshot] wouldn't be '''strictly''' necessary, if you at least provide that information when you upload a picture based on one of Valve's works. But of course creating such a template would standardize that and make it easier and quicker to insert that information when someone uploads images based on Valve's works. I would vote for template. Note that the [[:Template:PD|Public Domain template]] already exists here on the VDC.
 
::Specifically, tutorial images shouldn't be different from any other image, and should give credit to its original author, not necessarily via a template (unless, for example, it is released to the Public Domain, or on other similar situations where a template ''would'' be applicable). A simple ''"Image originally created by <name-here> on <date-here> for <tutorial-title-here>."'' would be great.
 
::Regarding the question about giving credit on tutorials:
 
::A) Either we're talking about a VDC wiki user that creates and develops a tutorial right here on the wiki, in which case I don't believe he should actually write down any credits (it's really not necessary because you can check the history page and see that he created the tutorial; plus it goes against the nature of a wiki...)
 
::B) A tutorial is ported from another site ('''preferably with permission!'''), and in that case my opinion is that you '''should definitely''' give credit to the original author.
 
::Guidelines for giving credit (situation B) would be, in my opinion: adding a <nowiki>== Credits ==</nowiki> header on the '''end''' of the tutorial's article page, whether it be
 
::#By use of a formated "credits template", as suggested above (I think it would be the best thing to do, for standardization purposes);
 
::#Simply by writing something along the lines of: ''"This tutorial was originally written by <name-here> on <date-here> at the site <site-here>, and later ported to the VDC."'' or any other variation (could also be standardized...). --[[User:Etset|Etset]] 03:15, 8 Feb 2008 (PST)
 
:::I am using this atm (only this image has been updated) [[:image:WiseClips03.jpg]]
 
:::Image for [[wiseClipped]] a tutorial ported from sdknuts.net originally created by --[[User:Mark WiseCarver|wisemx]], the image is a screenshot of software copyrighted by Valve." . --[[User:Plykkegaard|Peter [AGHL]]] 04:54, 8 Feb 2008 (PST)
 
::::Sounds perfect :) If a [[:Template:Valve-screenshot]] template is later created, we can then update images with the template instead. But for the time being that suffices ;) --[[User:Etset|Etset]] 05:05, 8 Feb 2008 (PST)
 
 
 
== Entity-Specific Templates ==
 
 
 
Shouldn't these just have their own category page?  This page feels like it's just more related to general wiki editing.  --[[User:4-Legged Tumor|4LT]] 04:00, 29 Jun 2008 (PDT)
 
 
 
== Is this a minor edit or major edit? ==
 
 
 
I've been conflicted on a few occasions from random editing sprees. The conflict is I'm not sure if the edit I made was minor or major. This may be self-explanatory for some, but maybe I can get confirmation. I realize fixing grammar, indentations, links, and other ''minor'' things should be marked as minor edits. I've been marking my edits as major when updating {{otherlang}} templates to {{otherlang2}}. Same question with the {{cleanup}} template. Would you consider this a major update or minor? --[[User:Mattshu|Mattshu]] 02:22, 2 March 2011 (UTC)
 

Latest revision as of 19:42, 19 July 2018

To create a topic, click here.

Page size

This page is large. Probably should be split into smaller, more digestible topics. It's almost doubled in length. --JeffLane 16:30, 29 December 2011 (PST)

Actually before I did the makeover, I thought about partitioning the page into several other 'sub-pages', maybe only putting the table of contents box on Help:Editing, then create Help:Editing/Page_Creation, Help:Editing/Editing_Toolbar, etc with their own information. I didn't do it because I didn't want to change the layout TOO much at once. —Mattshu 17:01, 29 December 2011 (PST)
It would seem to make sense to start with retaining the basic page creation and syntax, and then link to pages containing all of the specialized notice and entity templates. --JeffLane 18:08, 29 December 2011 (PST)
How's it look now? —Mattshu 18:42, 29 December 2011 (PST)
Definitely an improvement. --JeffLane 12:17, 30 December 2011 (PST)
I'm thinking about making this similar to Mattshu's idea because this still is a really long page that I doubt people will read in full. Any thoughts? Pinsplash (talk) 18:42, 15 July 2018 (UTC)
No thoughts? Bumping. Pinsplash (talk) 16:30, 17 July 2018 (UTC)
Glad we all did this democratically. Since no one objects, it shall happen soon. Pinsplash (talk) 03:42, 20 July 2018 (UTC)

Renaming pages

Is there a way to rename a page that has already been made? For example, I want to make a page for the 2014 standalone game Insurgency, but the original HL2 mod (a different version of the game) already has a page called Insurgency. I want to rename the mod page to something like "Insurgency (Mod)" so that a new page can be made called Insurgency. Is there a way to rename a page?

Greenhourglass (talk) 00:52, 8 December 2016 (UTC)

There is a move page feature. I'm not sure if it's restricted or not, but it's there. If you click the arrow next to the add to watchlist button (the star, up at the top bar, next to edit) there will be an option called move or similiar. - Dr. Orange (talk) 15:19, 8 December 2016 (UTC)

create a lobby-bot

Hi at all,

I want to code a program in python, which open a lobby for a Dota2 match on their servers and afterwards invite steam members to this lobby. I have already installed and imported the modules steam and dota2-0.2.6 but get confused by the mass of methods and their interactions. Is it possible with those modules and when yes, how?

thanks Unsigned comment added by ‎Cyberfischer (talkcontribs). Please use four tildes (~~~~) to sign your username.

This probably isn't the right place for this particular question. Also, remember to sign your comments on talk pages with four tilde signs (~~~~) which will automaticly insert your signature and date. -- Dr. Orange talk · contributions 17:40, 13 January 2017 (UTC)