commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gilles <>
Subject Re: [numbers] Editing user guide through git mirror?
Date Thu, 11 Oct 2018 12:51:23 GMT
Hi Eric.

On Wed, 10 Oct 2018 16:35:21 -0700, Eric Barnhill wrote:
> I am interested in adding some documentation to the commons Complex 
> user
> guide visible at
> . I was wondering if this is available to edit through the commons 
> git
> mirrors somehow? Apologies if this information is presented somewhere
> obvious.

I've added the missing file:;a=blob;f=commons-numbers-complex/src/site/xdoc/index.xml

Format is "xdoc".
It's a good place to explain the design and/or give some short
examples of API usage.

For more elaborate use-cases, we might want to create a special
purpose module (like for "Commons RNG") that contain fully
functional codes but not subject to the backward compatibility
constraint of the official codebase.

A longer-term documentation project could be to start a standalone
user guide that would contain one section per module, that would be
linked from the top-level web site, similar to

There is a "skeleton" for this here:;a=tree;f=src/site/xdoc/userguide
(not yet linked from the web site's homepage).


> Eric

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message