On Wed, Dec 11, 2013 at 10:35 PM, Graham Percival <gra...@percival-music.ca>wrote > > Fixing this doesn't require a reorganization. It requires > deleting the two incorrect bits, dumping a @ref{Submitting a > patch} or whatever the @node is called. On a similar note, > there's at least 2 "checklists before submitting a patch", at > least 1 of which has obsolete info. > > It may not "require" a reorganization, but is there a clearer, more concise way of presenting the information to where there is "one truth" and we can say, "if you want to contribute, go to this page for the process"? I think there needs to be a page that just outlines the basic process and branches based on what people are doing/using.
For instance, trying to synthesize the information in broad strokes (and I could be missing, misstating, or overgeneralizing something): 1) You need to be running Linux. 1.1: If you aren't using Linux, you can run Linux within your current operating system with LilyDev by following these instructions [link] 1.2: If you're already running Linux, great! Here's how to make sure you have all the packages and tools needed to work on LilyPond [link] 2) You need to connect to the git repository and download the source files. To understand what git is, go here [link]. 2.1: If you are using the command line, go here [link] 2.2: If you are not comfortable using the command line, go here to download lily-git.tcl [link] 3) Once you have downloaded the files, begin making your edits. Go here to see some of our development policies and practices [link] 4) As you edit the code, you will need to make one or more local commits to your code, to record your changes in a way that can be eventually integrated into the official source. 4.1: If you are using the command line, go here [link] 4.2: If you are using lily-git.tcl, go here [link] 5) When you finish editing, you need to create patch files that represent the changes you made 5.1: If you are using the command line, go here [link] 5.2: If you are using lily-git.tcl, go here [link] 6) With your patch files ready, go here for directions on how to upload your changes for review and eventually submit them to the source code [link] In my searching, I didn't find a page that really did this. Section 1.2 of the current CG should theoretically do this (based on the title), but it mostly just talks philosophically about git. Cheers, Carl
_______________________________________________ lilypond-devel mailing list lilypond-devel@gnu.org https://lists.gnu.org/mailman/listinfo/lilypond-devel