Calling for Server Guide reviewers/contributors - - TRUSTY
Mauricio Tavares
raubvogel at gmail.com
Thu Jan 2 18:36:31 UTC 2014
On Thu, Jan 2, 2014 at 6:13 PM, Peter Matulis
<peter.matulis at canonical.com> wrote:
> On 12/13/2013 01:25 AM, William Van Hevelingen wrote:
>> Yeah...looks like those didn't get converted. It shouldn't be that much
>> effort to fix all the headers. The internal links will have to be fixed
>> too, maybe a sed script can fix them up.
>>
>> I used sphinx to generate some html and posted it here:
>>
>> http://web.cecs.pdx.edu/~wvan/serverguide/remote-administration.html
>>
>> Not really sure how to make the index/homepage work yet but this is a
>> work in progress. :)
>>
>> Do you have any feedback so besides the other items you mentioned?
>>
>> Btw `make lintcheck` is awesome. It reports on all the broken external
>> links and we can hook it up to continuous integration.
>
> Here is my own attempt, including some branding. Feedback welcome.
> Yes, there are still broken links and the table of contents is too
> expansive. I really like the streamlined markup (see 'Show Source' at
> the bottom of the TOC).
>
> http://serverguide.papamike.ca:8081
>
I think it looks nice; I do like simple clean interfaces so you
can focus on content. How many header levels can you have with it?
With that in mind, now I have some free time I personally want to
figure out my ssh key issue and then populate some of the docs. For
that, I do not care about whatever format we choose; just make sure we
can convert from the current to the new style with as little pain as
possible.
In the mean time, I can work and flesh out my notes until I can start
working on those docs. I would like to be able to sit down on the
weekend and get stuff done. Ideally one topic per weekend.
> ~pmatulis
>
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
More information about the ubuntu-doc
mailing list