Talk:Coding conventions

message: This Code Conventions for the Java Programming Language document contains the standard conventions that we at Sun follow and recommend that others follow. It covers filenames, file organization, indentation, comments, declarations, statements, white space, naming conventions, programming practices and includes a code example.
Why have code conventions? Code conventions are important to programmers for a number of reasons:
    * 80% of the lifetime cost of a piece of software goes to maintenance.
    * Hardly any software is maintained for its whole life by the original author.
    * Code conventions improve the readability of the software, allowing engineers to understand new code more quickly and thoroughly. 
The Code Conventions for the Java Programming Language document was revised and updated on April 20, 1999. 
One class per file is not necessary true. In Jave or C#, sometimes there is a need to declare private classes which have to share source files with some other public classes.G7shihao (talk) 02:52, 20 February 2009 (UTC)
replies: text: Hi, this comment is from 2009. Meanwhile, several up-to-date Java-conventions are added to main article. Closing this comment is unspecific and has not seen further responses. If I missed anything, please re-open. KR   17387349L8764 (talk) 09:34, 15 April 2021 (UTC)
thread_title:  Code Conventions for the Java Programming Language

message: Trailing commas redirect here, but the article does not mention them.  — Preceding unsigned comment added by 81.191.75.7 (talk) 21:22, 29 July 2015 (UTC)
replies: text: It does not need to mention it specifically. TCs are part of coding guides, e. g. https://rules.sonarsource.com/c/RSPEC-878 KR  17387349L8764 (talk) 09:39, 15 April 2021 (UTC)
thread_title:  Trailing commas 

message: This article overlaps with Programming style and Coding standards and has no proper link to de:Programmierstil. I dare not change it, because I cannot decide which of the two articles could go to orcus or if both could get a clear different lemma.--Brf (talk) 15:46, 11 December 2009 (UTC)
replies: text: Hi, it looks messy yes. Programming style completely lacks references, which is inacceptable IMO. It was created 2003. Coding conventions was created 2006 and looks rather list-style. I think this. The best parts of Programming style should be merged into Coding conventions, into a sub-section "Style" or so WITH fresh referencing. Shocking that nobody answered this comment before or shows interest. If I find time, I come back to this. BR 17387349L8764 (talk) 09:43, 15 April 2021 (UTC)
thread_title:  Programming style 

message: Below are my proposals for some bigger (but straight-forward) changes to the below indicated 3 articles.
Feel free to comment them. It is Nov-5-2010 now, I will not start execution before some week(s) have passed by.
Proposals for smaller changes/merges to the (currently) 3 involved articles, I have not looked into yet. 
Also here, any proposals/comments are welcome.
Thanks, Ptrb (talk) 07:09, 5 November 2010 (UTC)
replies: text: Hi, correct, both pages need merging and updating. See my comment above (Section Programming style). I close this comment which looks like a duplicated-call for action. KR  17387349L8764 (talk) 09:44, 15 April 2021 (UTC)

text: DONE , Ptrb (talk) 08:27, 19 November 2010 (UTC)

text: DONE , Ptrb (talk) 07:55, 17 November 2010 (UTC)

text: DONE , Ptrb (talk) 21:15, 17 November 2010 (UTC)

text: DONE, Ptrb (talk) 07:50, 18 November 2010 (UTC)

text: DONE, Ptrb (talk) 08:26, 19 November 2010 (UTC)

text: DONE, Ptrb (talk) 08:26, 19 November 2010 (UTC)
thread_title:  Refactoring coding conventions and programming style articles 

message: ----
As a general direction for the refactoring of the following arcicles. I suggest to work towards the given focus for each of them.
# Coding conventions  — Have this as the leading article on this topic
# Programming style — Limit this to style (read: layout, formatting) only, move other content to respective articles
## Need to double check, if there are other articles on layout, formatting, that would need to be involved in these considerations
# Naming convention (programming) — Limit to naming conventions, move all naming convention specific to here, and point to this article from the other articles
Ptrb (talk) 16:50, 3 November 2010 (UTC)
replies: text: DONE , Ptrb (talk) 08:27, 19 November 2010 (UTC)
thread_title:  Proposal 0 

message: ----
The content provided here Programming_style#Appropriate_variable_names is more or less equivalent to the content provided here Naming_convention_(programming)#Business_value and here Naming_convention_(programming)#Length_of_identifiers. I suggest to
# delete the "get a b c" vs. "get hours minutes seconds" example here Programming_style#Appropriate_variable_names , and to stick to Naming_convention_(programming)#Business_value
# consider to migrate the statement on "In early programming languages" from Programming_style#Appropriate_variable_names to here Naming_convention_(programming)#Length_of_identifiers
Ptrb (talk) 14:52, 3 November 2010 (UTC)
replies: text: DONE , Ptrb (talk) 07:55, 17 November 2010 (UTC)
thread_title:  Proposal 1 

message: ----
Move this section Coding_conventions#Common_conventions (which is only dealing with naming issues) to this article Naming convention (programming), and to turn it into a level 1 section called "Examples" (or so). The following leftovers would stay in Coding_conventions#Common_conventions for now:
# No more than 80 characters, including white space, should be in one line.
# Only one statement should be on each line.
# An extra character should go early in a comment block to delimit the beginning of externally published or processed documentation.
Ptrb (talk) 16:36, 3 November 2010 (UTC)
replies: text: DONE , Ptrb (talk) 21:15, 17 November 2010 (UTC)
thread_title:  Proposal 2 

message: ----
Move complete following sections from Programming style to Coding conventions
# Programming_style#External_links
# Programming_style#Coding_conventions_for_languages
# Programming_style#Coding_conventions_for_projects
Ptrb (talk) 16:53, 3 November 2010 (UTC)
replies: text: DONE, Ptrb (talk) 07:50, 18 November 2010 (UTC)
thread_title:  Proposal 3 

message: ----
Next to the general article on Naming convention (programming), 
* There is a category :Category:Naming conventions, to which relevant articles may (and should?) be assigned.
** (Just added this to the SeeAlso section here Naming convention (programming))
* There are several articles that deal with specific naming conventions, here it should be ensured that the Naming convention (programming) does not hold (too much) redundancy and rather refers to these articles.
Currently (Nov-5-2010) located articles are:
* CamelCase ( and is mentioned somewhere in Naming convention (programming) )
* Hungarian notation ( and is mentioned somewhere in Naming convention (programming) )
** Leszynski naming convention (The Leszynski naming convention (or LNC) is a variant of Hungarian notation)
*** Also check if LNC is listed at the respective ambiguation page ( DONE, is listed there )
* Sigil (computer programming)
Ptrb (talk) 14:08, 5 November 2010 (UTC)
thread_title:  Proposal 4 

message: ----
* Get rid of, or clean up, or move to respective sections: Coding_conventions#Further_conventions
: DONE, Ptrb (talk) 08:26, 19 November 2010 (UTC)
thread_title:  Proposal 5 

message: ----
* Improve sectin Coding_conventions#Common_conventions, maybe turn in sort of "see also" section, pointing to 
** naming conventions
** layout/style conventions 
** other? conventions
: DONE, Ptrb (talk) 08:26, 19 November 2010 (UTC)
thread_title:  Proposal 6 

message: In case you should be watching this, please just give me some time to write down my concerns and suggestions.
# Changed redirect on Coding standard to point to Coding conventions — Ptrb (talk) 16:15, 3 November 2010 (UTC)
thread_title:  Refactoring coding conventions and programming style articles - Summary of preparations and changes made 

message: "If a for loop uses just a letter 'i' for the index this is not very meaningful . If , however , the word 'index' is used this is much more meaningful ."
They way I've always been taught is to use 'i' as an index. It's a pretty standard convention (as well as using j, k etc. for subsequent nested loops) and most people who see 'i = 0' in a line of code instantly associate it with an forthcoming loop.
Using 'index' could be considered verbose.
41.133.164.39 (talk) 20:53, 6 June 2013 (UTC)
thread_title:  Meaningfulness and Consistency 

message: Where do these "meaningful names" come from?
Any thoughts, rules, practices, do's, don'ts on "meaningful names?"  DEddy (talk) 21:31, 12 July 2013 (UTC)
replies: text: Hi, searching article for "Meaningful names" finds 0 results. What do you mean? I close this, your comment wasn't answered for a while. Please open again if needed. KR  17387349L8764 (talk) 09:48, 15 April 2021 (UTC)

text: The name should describe the data in terms the user of the application can understand. For example ‘sample_size” or “median_age” instead of something like ”x”, “ss”, or “med.” Other than that there are a lot of thoughts on what the form of a name should be, for example “pszCustomerName” is Hungarian Notation for a pointer (p) to a null-terminated string (sz) containing a customer name. Peter Flass (talk) 19:14, 15 April 2021 (UTC)
thread_title:  Meaningful Names? 

message: The reference one lead to a page with broken llnk only, it should be updated.  — Preceding unsigned comment added by 199.243.65.6 (talk) 21:37, 6 May 2014 (UTC)
replies: text: Please help and update it. Your comment is from 2014, this is too old. Ref 1 is currently working. BR  17387349L8764 (talk) 09:46, 15 April 2021 (UTC)
thread_title:  Broken link for reference 1 

message: Hello fellow Wikipedians,
I have just modified one external link on Coding conventions. Please take a moment to review my edit. If you have any questions, or need the bot to ignore the links, or the page altogether, please visit this simple FaQ for additional information. I made the following changes:
*Added  tag to http://www.dit.upm.es/ork/documents/adahis.pdf
*Added archive https://web.archive.org/web/20100527142102/http://software.gsfc.nasa.gov/AssetsApproved/PA2.4.1.1.1.pdf to http://software.gsfc.nasa.gov/AssetsApproved/PA2.4.1.1.1.pdf
*Added  tag to ftp://ftp.estec.esa.nl/pub/wm/wme/bssc/bssc983.pdf
When you have finished reviewing my changes, you may follow the instructions on the template below to fix any issues with the URLs.
Cheers.—InternetArchiveBot (Report bug) 05:26, 10 August 2017 (UTC)
thread_title:  External links modified 

message: Hello fellow Wikipedians,
I have just modified one external link on Coding conventions. Please take a moment to review my edit. If you have any questions, or need the bot to ignore the links, or the page altogether, please visit this simple FaQ for additional information. I made the following changes:
*Added archive https://web.archive.org/web/20061215120657/http://www.xprogramming.com/xpmag/whatisxp.htm to http://www.xprogramming.com/xpmag/whatisxp.htm
When you have finished reviewing my changes, you may follow the instructions on the template below to fix any issues with the URLs.
Cheers.—InternetArchiveBot (Report bug) 10:00, 20 September 2017 (UTC)
thread_title:  External links modified