[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Contributions to Guile
From: |
Thompson, David |
Subject: |
Re: Contributions to Guile |
Date: |
Mon, 8 Feb 2016 16:37:23 -0500 |
On Mon, Feb 8, 2016 at 4:28 PM, Chad Albers <address@hidden> wrote:
> On Mon, Feb 8, 2016 at 2:05 PM, Christopher Allan Webber
> <address@hidden> wrote:
>> Ludovic Courtès writes:
>>
>>> Christopher Allan Webber <address@hidden> skribis:
>>>
>>>> Chad Albers writes:
>>>
>>> [...]
>>>
>>>>> b. More robust documentation system - texinfo is not the greatest. And
>>>>> it's non-trivial to generate any documentation (including texinfo) for
>>>>> modules.
>>>>
>>>> Texinfo is pretty nice to use if you're an emacs user... in fact, if
>>>> you're an emacs user, it's the best documentation reading system in the
>>>> world. But not everyone's an emacs user.
>>>
>>> I think Texinfo is OK even if you’re not an Emacs user, no? Especially
>>> with the just-release 6.1 where menus can (finally!) be automatically
>>> generated.
>>>
>>>> If the html export was nicely themed
>
> IMHO, HTML has clearly won the documentation game. I believe it goes
> without saying that most developers have a web browser installed,
> rather than a textinfo reader. The more the guile project publishes
> easily searchable (without google) documentation in the most
> accessible media format the better for guile.
We can clearly have both. Nice looking HTML docs on the Guile website
are possible with a little CSS magic and some nice fonts. Thanks to
Texinfo, we also get Info and PDF versions! Having the Guile
documentation nicely integrated with my editor (Emacs) is a *huge*
productivity booster. Having HTML-only documentation would be a major
setback for Guile.
- Dave
- Re: Contributions to Guile, (continued)
- Re: Contributions to Guile, Christopher Allan Webber, 2016/02/08
- Re: Contributions to Guile, Ludovic Courtès, 2016/02/08
- Re: Contributions to Guile, Christopher Allan Webber, 2016/02/08
- Re: Contributions to Guile, Ricardo Wurmus, 2016/02/08
- Re: Contributions to Guile, Ludovic Courtès, 2016/02/08
- Re: Contributions to Guile, Ricardo Wurmus, 2016/02/08
- Re: Contributions to Guile, Ludovic Courtès, 2016/02/08
- Re: Contributions to Guile, Christopher Allan Webber, 2016/02/08
- Re: Contributions to Guile, Ludovic Courtès, 2016/02/08
- Re: Contributions to Guile, Chad Albers, 2016/02/08
- Re: Contributions to Guile,
Thompson, David <=
Re: Contributions to Guile, Chad Albers, 2016/02/09