)]}'
{"doc/contributor-guide/source/api-guides.rst":[{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"a2bb782e74316276f2c9590d58f9e9be1b850596","unresolved":false,"context_lines":[{"line_number":15,"context_line":"files. To convert from WADL to RST, use a tool called `wadl2rst`_. Then store"},{"line_number":16,"context_line":"the RST and YAML files in your project repository in an ``api-ref`` directory."},{"line_number":17,"context_line":"The nova project has an example you can follow, including tox jobs for running"},{"line_number":18,"context_line":"``tox -e api`` within the wadl2rst directory to generate the documents."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Alternatively, a project can describe their API with Swagger or OpenAPI. To"},{"line_number":21,"context_line":"learn more about the Swagger format and OpenAPI initiative, refer to"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a122d0e_3a8363ce","line":18,"range":{"start_line":18,"start_character":26,"end_line":18,"end_character":34},"updated":"2016-04-15 16:57:54.000000000","message":"``wadl2rst``","commit_id":"b3fac6e589086373185c6709edc1f66e4c07c168"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"bc5ba5864ad56fd1d2ccd985106a423c9fb8344e","unresolved":false,"context_lines":[{"line_number":15,"context_line":"files. To convert from WADL to RST, use a tool called `wadl2rst`_. Then store"},{"line_number":16,"context_line":"the RST and YAML files in your project repository in an ``api-ref`` directory."},{"line_number":17,"context_line":"The nova project has an example you can follow, including tox jobs for running"},{"line_number":18,"context_line":"``tox -e api`` within the wadl2rst directory to generate the documents."},{"line_number":19,"context_line":""},{"line_number":20,"context_line":"Alternatively, a project can describe their API with Swagger or OpenAPI. To"},{"line_number":21,"context_line":"learn more about the Swagger format and OpenAPI initiative, refer to"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a122d0e_c6489030","line":18,"range":{"start_line":18,"start_character":26,"end_line":18,"end_character":34},"in_reply_to":"1a122d0e_3a8363ce","updated":"2016-04-16 01:46:40.000000000","message":"Done","commit_id":"b3fac6e589086373185c6709edc1f66e4c07c168"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"a2bb782e74316276f2c9590d58f9e9be1b850596","unresolved":false,"context_lines":[{"line_number":53,"context_line":""},{"line_number":54,"context_line":"#. Create a Python virtual environment.::"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"    mkvirtualenv wadl2rst"},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"#. Install the requirements and ``wadl2rst`` in the virtual environment.::"},{"line_number":59,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a122d0e_5a51ff61","line":56,"range":{"start_line":56,"start_character":4,"end_line":56,"end_character":16},"updated":"2016-04-15 16:57:54.000000000","message":"virtualenv not mkvirtualenv","commit_id":"b3fac6e589086373185c6709edc1f66e4c07c168"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"bc5ba5864ad56fd1d2ccd985106a423c9fb8344e","unresolved":false,"context_lines":[{"line_number":53,"context_line":""},{"line_number":54,"context_line":"#. Create a Python virtual environment.::"},{"line_number":55,"context_line":""},{"line_number":56,"context_line":"    mkvirtualenv wadl2rst"},{"line_number":57,"context_line":""},{"line_number":58,"context_line":"#. Install the requirements and ``wadl2rst`` in the virtual environment.::"},{"line_number":59,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a122d0e_e64b0c2a","line":56,"range":{"start_line":56,"start_character":4,"end_line":56,"end_character":16},"in_reply_to":"1a122d0e_5a51ff61","updated":"2016-04-16 01:46:40.000000000","message":"Done","commit_id":"b3fac6e589086373185c6709edc1f66e4c07c168"},{"author":{"_account_id":16308,"name":"Sheel Rana","email":"ranasheel2000@gmail.com","username":"sheel.rana"},"change_message_id":"16283f129c58c4c819836f81c68c64ca9c47203f","unresolved":false,"context_lines":[{"line_number":97,"context_line":"   warnings about generating the documents twice, or documents not being in"},{"line_number":98,"context_line":"   a toc directive."},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"#. Next, run the ``fairy-slipper`` tool to generate individual migrated"},{"line_number":101,"context_line":"   ``\u003coperationid\u003e.yaml`` files."},{"line_number":102,"context_line":""},{"line_number":103,"context_line":"   These files can be referenced from the RST files, and the migration tool"},{"line_number":104,"context_line":"   inserts pointers to parameters, such as::"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a122d0e_04bbadc5","line":101,"range":{"start_line":100,"start_character":2,"end_line":101,"end_character":32},"updated":"2016-04-15 17:58:55.000000000","message":"It would be helpful if steps to run fairy-slipper could be written like \na. how to install\nb. in which directory fairy-slipper to run\nc. which fairy-slipper command(multiple commands are there) to run.","commit_id":"b3fac6e589086373185c6709edc1f66e4c07c168"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"bc5ba5864ad56fd1d2ccd985106a423c9fb8344e","unresolved":false,"context_lines":[{"line_number":97,"context_line":"   warnings about generating the documents twice, or documents not being in"},{"line_number":98,"context_line":"   a toc directive."},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"#. Next, run the ``fairy-slipper`` tool to generate individual migrated"},{"line_number":101,"context_line":"   ``\u003coperationid\u003e.yaml`` files."},{"line_number":102,"context_line":""},{"line_number":103,"context_line":"   These files can be referenced from the RST files, and the migration tool"},{"line_number":104,"context_line":"   inserts pointers to parameters, such as::"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1a122d0e_86469821","line":101,"range":{"start_line":100,"start_character":2,"end_line":101,"end_character":32},"in_reply_to":"1a122d0e_04bbadc5","updated":"2016-04-16 01:46:40.000000000","message":"Done","commit_id":"b3fac6e589086373185c6709edc1f66e4c07c168"}]}