Skip to content

Conversation

mikeengland
Copy link

I recently started using drfdocs and wanted to add some documentation onto each view I have. Some extra documentation I have needed to be formatted (line breaks etc) and was longer than a single line.

This simple change allows reStructuredText to be added to a DRF View docstring, meaning users can add structured documentation that can be viewed when clicking on each API on the docs page.

@ghost
Copy link

ghost commented Jul 19, 2016

Markdown support would be more useful here since it is already used in DRF's html views for docstrings.

@mikeengland
Copy link
Author

mikeengland commented Jul 19, 2016

If markdown would be more useful for this project it would be very easy to implement. I'll look at changing it in this pull request.

Edit: Changed functionality to use markdown instead of rst.

@mikeengland mikeengland changed the title Added reStructuredText support for endpoint docstrings Added markdown support for endpoint docstrings Jul 19, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.