search

JakobOvrum / bootDoc

Theme for the DDoc documentation generator
Other
36 stars 7 forks source link

Sort out which macros borrowed from Phobos are standard #17

Closed JakobOvrum closed 11 years ago

JakobOvrum commented 12 years ago

It seems like most of them should be moved to the Phobos demo repository's settings.ddoc as they are project-specific, but some of them are universally useful.

These are my suggestions: RPAREN, LPAREN, LESS, GREATER, D and BIGOH.

It would also be nice to have standard symbol referencing and cross-module referencing macros, but I'm not sure what the optimal implementation of them is.

The BUGZILLA macro is also interesting, and I think it'd be cool to have a standard macro named BUGTRACKER or something where the URL is configured in settings.ddoc.

JakobOvrum commented 11 years ago

With #27 merged, this is closed to solved. Just need documentation on the wiki as well as figuring out if a bug tracker macro is worth having (it's really simple anyway, and considering most bootDoc projects I've seen so far use Github which comes with an integrated issue tracker, I'd say it's definitely a useful macro).

Also gotta get rid of the rest of the Phobos-specific cruft.

JakobOvrum commented 11 years ago

The standard macros are now documented on the wiki.

JakobOvrum commented 11 years ago

Issue tracker support is now in (b40137b597ac264214f1df9099627c79a9f2009b), solving the final piece in this issue.