Re: New lilypond website - documentation

[David Kastrup]

"Andrew Bernard"  writes:

> Hello All,
>
> Since the website has suddenly come up again as a topic, while I
> disagree with a lot of the talk here, allow me for once to say
> something positive. Concerning the documentation on the website, this
> has always been a good idea because it is indexed by search engines –
> I often find it is easier to google a search for something in the
> lilypond manuals than using other ways! So keeping the documentation
> online, and building it from the source code in an automated process
> is an excellent design criterion.
>
> In terms of ‘modernity’ which people seem to be keenly interested in
> [I am not convinced that this is a primary goal of web development, as
> more often than not modernity is mere ephemeral fashion], then I would
> like to point out that there is an excellent open source solution for
> online documentation called ReadTheDocs.

Let's put this into perspective: at any point of time, there are few
people working on LilyPond's core documentation.

LilyPond has been around for dozens of years.  So has its documentation.
So has Texinfo.  I don't think we can expect the manpower to shift
everything (PDF, HTML, Info) to a new documentation source format every
dozen years or so.

> http://docs.readthedocs.io/en/latest/
>
> Since I believe one should put one’s money where one’s mouth is (!) I
> would be very happy to investigate this solution and code and
> implement it, and maintain it for the lilypond community.

And all translations?  For, let's say, 20 years at least?

I just don't think that LilyPond can sensibly afford to hop on every
passing bandwagon with its 1000+ pages of English documentation and its
multiple thousands of translated pages.

-- 
David Kastrup

___
lilypond-user mailing list
lilypond-user@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-user

Re: New lilypond website - documentation

[John Roper]

Read the docs is based on sphinx which is python's documentation generator (
http://www.sphinx-doc.org/en/1.4.9/). As for website design, the layout
design is fine with me as long as it has new styling like I have done (not
that I am saying that mine should be chosen). I am going to work on
incorporating this new design into the actual generated docs.

On Tue, Nov 29, 2016 at 8:46 PM, Andrew Bernard 
wrote:

> Hello All,
>
> Since the website has suddenly come up again as a topic, while I disagree
> with a lot of the talk here, allow me for once to say something positive.
> Concerning the documentation on the website, this has always been a good
> idea because it is indexed by search engines – I often find it is easier to
> google a search for something in the lilypond manuals than using other
> ways! So keeping the documentation online, and building it from the source
> code in an automated process is an excellent design criterion.
>
> In terms of ‘modernity’ which people seem to be keenly interested in [I am
> not convinced that this is a primary goal of web development, as more often
> than not modernity is mere ephemeral fashion], then I would like to point
> out that there is an excellent open source solution for online
> documentation called ReadTheDocs.
>
> http://docs.readthedocs.io/en/latest/
>
> Since I believe one should put one’s money where one’s mouth is (!) I
> would be very happy to investigate this solution and code and implement it,
> and maintain it for the lilypond community.
>
> As another point, in relation to renovated websites, the Haskell
> programming language website has had a recent makeover very much in line
> with the ideas people are discussing here. Similarities abound – Haskell is
> a superb open source Functional Programming language, that like lilypond,
> has no commercial basis, but does seek to increase its industry mindshare,
> at which it is becoming increasingly successful.
>
> https://www.haskell.org/
>
> Andrew
>
>
>
>
>
> ___
> lilypond-user mailing list
> lilypond-user@gnu.org
> https://lists.gnu.org/mailman/listinfo/lilypond-user
>
>


-- 
John Roper
Freelance Developer and Simulation Artist
Boston, MA USA
http://jmroper.com/
___
lilypond-user mailing list
lilypond-user@gnu.org
https://lists.gnu.org/mailman/listinfo/lilypond-user