Commit Graph
4 Commits
Author SHA1 Message Date
Xavier Morel 40ca8557e9 [FIX] building documentation with P3
* fix P3 incompatibilities in doc/_extensions
* vendor pyjsdoc, strip out everything we're not using and make what's
  left P3-compatible (upstream is not P3 compliant)
* drop undeclared dependency on attrs as it turns out not to be much
  used
2017-10-10 13:29:11 +02:00
Xavier Morel 8071742959 [FIX] doc: almost all warnings & drop mercurial dependency
* fix all warnings wrt patch application & al, only warning left is
  only exercise-kanban being auto-guessed as an xml+django file and
  then lexing failed (because it's only a small snippet)
* update sphinx-patchqueue to drop the requirement on mercurial for
  patch introspection and application, though that means application
  is significantly less forgiving (fuzzy application was not
  implemented)
2017-10-10 12:26:00 +02:00
Xavier Morel 313f69e948 [ADD] doc: JS document extraction system
* Fix a bunch of ill-documented/incomplete/incorrect method docs
* add start of Sphinx extension to extract & integrate jsdoc into
  Sphinx documentation:

  - parse JS files (and don't blow up), uses a fork of pyjsparser as
    the project currently does not parse comments
  - extract cross-module dependency information
  - parse JsDoc comments using pyjsdoc and infer structure from code &
    jsdoc
  - ``ast`` CLI printing a simplified AST of the input files
  - ``dependencies`` creating a dependency graph of either all modules
    in the provided input files or the modules matching the specified
    filters (warning: will not work if missing dependencies),
    generates a .dot file
  - ``extractor`` generating a plain text module documentation (mix of
    rst and markdown styles, not anything formal)
* sphinx extension with an "automodule" directive taking a module name
  and generating the documentation for it
2017-09-18 11:54:36 +02:00
ALIANE Abdelouahab 05400f56b3 [ADD] documentation requirements
add new requirements to generate the docs.
2014-12-22 14:48:15 +01:00