[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidde
From: |
graham |
Subject: |
Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden) |
Date: |
Mon, 05 Dec 2016 00:02:53 -0800 |
Reviewers: ,
Message:
Suggestion from Karlin High, modified by Simon Albrecht. Please review.
Description:
Doc CG 6.1: Add caveat on website work
Please review this at https://codereview.appspot.com/315130043/
Affected files (+19, -2 lines):
M Documentation/contributor/website-work.itexi
Index: Documentation/contributor/website-work.itexi
diff --git a/Documentation/contributor/website-work.itexi
b/Documentation/contributor/website-work.itexi
index
588d705f1b4facfbd11797a6122b95aae935d2b4..6e858f0c56788fafb4ab342c63787791c8099731
100644
--- a/Documentation/contributor/website-work.itexi
+++ b/Documentation/contributor/website-work.itexi
@@ -14,8 +14,25 @@
@section Introduction to website work
The website is @emph{not} written directly in HTML;
-instead, the source is Texinfo, which is then generated into HTML,
-PDF, and Info formats. The sources are
+instead it is autogenerated along with the documentation through a
+sophisticated setup, using Texinfo source files. Texinfo is the
+standard for documentation of GNU software and allows generating
+output in HTML, PDF, and Info formats, which drastically reduces
+maintenance effort and ensures the contents of the website to be
+up to date with the rest of the documentation. This makes the
+environment for improving the website rather different from common
+web development.
+
+If you have not contributed to LilyPond before, a good starting
+point might be incremental changes to the CSS file, to be found at
address@hidden://lilypond.org/css/lilypond-website.css} or in the
+LilyPond source code at @file{./Documentation/css/lilypond-website.css}.
+
+Large scale structural changes tend to require familiarity with
+the project in general, a track record in working on LilyPond
+documentation as well as a prospect of long-term commitment.
+
+The Texinfo source file for generating HTML are to be found in
@example
Documentation/web.texi
- Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden),
graham <=
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), graham, 2016/12/05
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Urs Liska, 2016/12/05
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Simon Albrecht, 2016/12/05
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Graham Percival, 2016/12/05
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Carl Sorensen, 2016/12/05
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Graham Percival, 2016/12/07
- Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Federico Bruni, 2016/12/22
Re: Doc CG 6.1: Add caveat on website work (issue 315130043 by address@hidden), Carl . D . Sorensen, 2016/12/05