Date: Tue, 12 Dec 2017 16:53:15 -0500
From: Drew DeVault <sir@cmpwn.com>
To: alpine-devel@lists.alpinelinux.org
Subject: Re: [alpine-devel] Improving Alpine Linux documentation
Message-ID: <20171212215314.GA4441@miku>
References: <20171212201302.GA9334@eddy>
 <20171212202301.GA26329@miku>
 <20171212202626.GB9334@eddy>
 <20171212203147.GA27466@miku>
 <20171212203455.GC9334@eddy>
Precedence: list
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20171212203455.GC9334@eddy>

On 2017-12-12 11:34 PM, Consus wrote:
> True. But this is more about the high-level documentation, not the
> tool's synopsis.

Man pages are not limited to the synopsis of tools. Large portions of
information currently on the wiki is on-topic for man pages:

https://wiki.alpinelinux.org/wiki/Alpine_Linux_package_management

apk(8)

https://wiki.alpinelinux.org/wiki/Apk_spec

apk-database(7)

https://wiki.alpinelinux.org/wiki/Creating_an_Alpine_package
https://wiki.alpinelinux.org/wiki/APKBUILD_Reference

abuild(1)

APKBUILD(7)

and so on. If an overhaul of the core docs on the wiki is due, then I
think lots of it should be moved into man pages as the single source of
truth.


---
Unsubscribe:  alpine-devel+unsubscribe@lists.alpinelinux.org
Help:         alpine-devel+help@lists.alpinelinux.org
---