Date: Tue, 12 Dec 2017 15:23:02 -0500
From: Drew DeVault <sir@cmpwn.com>
To: Consus <consus@ftml.net>
Cc: alpine-devel@lists.alpinelinux.org
Subject: Re: [alpine-devel] Improving Alpine Linux documentation
Message-ID: <20171212202301.GA26329@miku>
References: <20171212201302.GA9334@eddy>
Precedence: list
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20171212201302.GA9334@eddy>

I don't really have any advice for what to do with the wiki, but
regarding Alpine's core documentation I have some thoughts. Something
that bothers me about Alpine (and that I'd like to contribute to
improving) is the lack of man pages for Alpine core stuff. I think a
substantial portion of the core docs can and should be done this way,
rather than on the wiki - though it would be nice to render the man
pages to HTML for display on the web, too.

No one likes writing roff so I've been working on a tool recently to
help with this:

https://git.sr.ht/~sircmpwn/scdoc

If there's no opposition to this I was hoping to start writing man pages
for apk shortly.


---
Unsubscribe:  alpine-devel+unsubscribe@lists.alpinelinux.org
Help:         alpine-devel+help@lists.alpinelinux.org
---