• Bugfix: Sphinx warnings fixed, if need-collapse was used. (#46 )
  • Bugfix: dark.css, blank.css and common.css used wrong need-container selector. Fixed.


  • Deprecated: needfilter is replaced by needlist, needtable or needdiagram. Which support additional options for related layout.
  • Improvement: Added needtable directive.
  • Improvement: Added DataTables support for needtable (including table search, excel/pdf export and dynamic column selection).
  • Improvement: Added needs_id_regex, which takes a regular expression and which is used to validate given IDs of needs.
  • Improvement: Added meta information shields on documentation page
  • Improvement: Added more examples to documentation
  • Bugfix: Care about unneeded separator characters in tags (#36)
  • Bugfix: Avoiding multiple registration of resource files (js, css), if sphinx gets called several times (e.g. during tests)
  • Bugfix: Needs with no status shows up on filters (#45)
  • Bugfix: Supporting Sphinx 1.7 (#41)


  • Bugfix: Supporting plantnuml >= 0.9 (#38)
  • Bugfix: need_outgoing does not crash, if given need-id does not exist (#32 )


  • Improvement: Added configuration option needs_role_need_template.
  • Bugfix: Referencing not existing needs will result in build warnings instead of a build crash.
  • Refactoring: needs development files are stored internally under sphinxcontrib/needs, which is in sync with most other sphinxcontrib-packages.


  • Bugfix: dark.css was missing in
  • Improvement: Better output, if configured needs_css file can not be found during build.


  • Bugfix: Added python2/3 compatibility for needs_import.


  • Bugfix: needs with no status are handled the correct way now.


  • Bugfix: Import statements are checked, if Python 2 or 3 is used.


  • Improvement: Added “dark.css” as style
  • Bugfix: Removed “,” as as separator of links in need presentation.


  • Improvement: Added config parameter needs_css, which allows to set a css file.
  • Improvement: Most need-elements (title, id, tags, status, …) got their own html class attribute to support custom styles.
  • Improvement: Set default style “modern.css” for all projects without configured needs_css parameter.


  • Improvement: Added config parameters needs_statuses and needs_tags to allow only configured statuses/tags inside documentation.
  • Bugfix: Added LICENSE file (MIT)


  • Bugfix: Removed jinja activation


  • Bugfix: Added missing needimport_template.rst to package
  • Bugfix: Corrected version param of needimport


  • Improvement: :links:, :tags: and other list-based options can handle “,” as delimiter (beside documented “;”). No spooky errors are thrown anymore if “,” is used accidentally.




  • Improvement/Bug: Updated default node_template to use less space for node parameter representation
  • Improvement: Added :filter: option to needimport directive
  • Bugfix: Set correct default value for need_list option. So no more warnings should be thrown during build.
  • Bugfix: Imported needs gets sorted by id before adding them to the related document.


  • Improvement: New option tags for needimport directive
  • Bugfix: Handling of relative paths in needs builder


  • New feature: Directive needimport implemented
  • Improvement: needs-builder stores needs.json for all cases in the build directory (like _build/needs/needs.json) (See issue comment)
  • Bugfix: Wrong version in needs.json, if an existing needs.json got imported
  • Bugfix: Wrong need amount in initial needs.json fixed


  • Bugfix: Setting correct working directory during import
  • Bugfix: Better config handling, if Sphinx builds gets called multiple times during one single python process. (Configs from prio sphinx builds may still be active.)
  • Bugifx: Some cleanups for using Sphinx >= 1.6


  • Bugfix: Added missing dependency to Sphinx>=1.6


  • Improvement: Builder needs added, which exports all needs to a json file.


  • Bugfix: Build has crashed, if sphinxcontrib-needs was loaded but not a single need was defined.


  • Bugfix: Added support for multiple sphinx projects initialisations/builds during a single python process call.
    (Reliable sphinxcontrib-needs configuration separation)




  • Restructured code
  • Restructured documentation
  • Improvement: Role need_outgoing was added to print outgoing links from a given need
  • Improvement: Role need_incoming was added to print incoming links to a given need


  • Bugfix: Reactivated jinja execution for documentation.


  • Improvement: complex filter for needfilter directive supports regex searches.
  • Improvement: complex filter has access to nearly all need variables (id, title, content, …)`.
  • Bugfix: If a duplicated ID is detected an error gets thrown.


  • Improvement: needfilter directives supports complex filter-logic by using parameter Filtering needs.


  • Improvement: Added word highlighting of need titles in linked pages of svg diagram boxes.


  • Bugfix for custom needs_types: Parameter in was not taken into account.


  • Reimplemented needlist as alias for needfilter
  • Added need directive/need as part of the default needs_types configuration.


Initial start for the changelog

  • Free definable need types (Requirements, Bugs, Tests, Employees, …)
  • Allowing configuration of needs with a
  • directive name
  • meaningful title
  • prefix for generated IDs
  • color
  • Added needfilter directive
  • Added layouts for needfilter:
  • list (default)
  • table
  • diagram (based on plantuml)
  • Integrated interaction with the activated plantuml sphinx extension
  • Added role need to create a reference to a need by giving the id