| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
| |
Now we have a single tool for the general ontology documentation
and the per-class/property one.
|
|
|
|
|
| |
Less toggles on the doc generation tool, more seamless documentation
blending. Sounds like win-win.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Ontology docs weren't in a much good shape, besides many ontologies
being seriously underdocumented (something which should improve
separately), the generated docs were little more than a data dump,
and the diagrams shown were broken, confusing, or both. This all
amounts to quite counter-productive developer docs.
So the ontology docs have been refurbished, the per-ontology
descriptions are still useful, but have been stripped of all images,
and the docs overall are now completely class-centric, per
rdfs:Resource subclass we now get:
- Ascii diagram of its local hierarchy, up to all its ancestors and
down to all its direct children.
- All properties that affect the specific class. This is notably
more intuitive now as there's properties defined on one ontology
that are in the domain of classes in another ontology, something
which you couldn't get at a glance in the previous docs
- It clearly states which properties supersede which superproperties,
which again makes it easier if those apply for the class at hand.
The result feels quite neater, and will indeed be more resembling
to other gtk-doc generated API docs.
|
| |
|
|
|
|
|
| |
Found here:
http://git.debian.org/?p=devscripts/devscripts.git;a=blob;f=scripts/licensecheck.pl;h=62e9fbe94d7b63c671e4239f790b18edd2dfaa6c;hb=HEAD
|
| |
|
|
There is now a new gtk-doc reference for ontology, which is created
from data/ontologies/*. docs/tools contains the programs to generate
both docbook and graphs, these are dumped on docs/reference/ontology,
which is compiled afterwards.
Documentation generation happens on make, ontology graphs require
graphviz and are only generated on distcheck, A base image is
committed, so people don't need graphviz to have a peek.
|