It will have these benefits:
- Documents the same version as installation uses.
- Works when phabricator.com is down or inaccessible.
- It can link back to installation, e.g. to provide a link for uploading images from Remarkup reference.
It will have these benefits:
Status | Assigned | Task | ||
---|---|---|---|---|
Open | joshuaspence | T4558 Make Diviner useful for third-parties | ||
Open | epriestley | T823 Add image support to Diviner | ||
Open | joshuaspence | T2284 Make Diviner namespace aware | ||
Open | None | T1089 Use information from assert_instances_of() in generated documentation | ||
Restricted Maniphest Task | ||||
Resolved | epriestley | T988 Make Diviner a first-class application | ||
Restricted Maniphest Task |
I'd like to at the very least be able to point to doxygen/other externally generated documentation generated from my own projects. That is, have a Harbormaster (for example) build plan that would run doxygen (or other external tool) on my project and dump the result in some place that Phabricator can serve it up.
You can build external documentation through Harbormaster, but we probably won't serve it through Phabricator anytime soon. Serving arbitrary HTML content via Phabricator creates a lot of security issues that we'd need to work through.
("can build" in the sense of "will be able to build, once Harbormaster is a little farther along").
You can build external documentation through Harbormaster, but we probably won't serve it through Phabricator anytime soon. Serving arbitrary HTML content via Phabricator creates a lot of security issues that we'd need to work through.
I'd be fine for the time being with the link opening a new window/tab. The main thing is I'd like to avoid extra Apache configuration, for example: having a directory under phabricator/webroot/externalContent
("can build" in the sense of "will be able to build, once Harbormaster is a little farther along").
Right, I'm trying to think a little farther along here :-)
I'm going to close this as resolved. There's more work to be done, but it's covered in linked tasks, particularly T4558.
(Notably, while Diviner is first-class, it's not really usable outside of Phabricator itself yet. T4558 covers making it more general.)