)]}'
{"doc/source/index.rst":[{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":2,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":".. toctree::"},{"line_number":5,"context_line":"   :maxdepth: 2"},{"line_number":6,"context_line":"   :caption: Contents:"},{"line_number":7,"context_line":"    Deployment guide"},{"line_number":8,"context_line":"      Overview"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_5787bbb7","line":5,"range":{"start_line":5,"start_character":0,"end_line":5,"end_character":15},"updated":"2019-02-06 09:14:58.000000000","message":"OSA didn\u0027t go that far to prevent people for being overwhelmed when they reach the main page.\n\nHowever, OSA is branched, and therefore it\u0027s harder to read.\n\nI think we can try it.","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":5,"context_line":"   :maxdepth: 2"},{"line_number":6,"context_line":"   :caption: Contents:"},{"line_number":7,"context_line":"    Deployment guide"},{"line_number":8,"context_line":"      Overview"},{"line_number":9,"context_line":"      Requirements (k8s, docker, ...)"},{"line_number":10,"context_line":"      Prepare the deployment host"},{"line_number":11,"context_line":"      Prepare the target hosts"},{"line_number":12,"context_line":"      Configure the deployment"},{"line_number":13,"context_line":"      Deploy OpenStack-Helm"},{"line_number":14,"context_line":"      Verify OpenStack-Helm"},{"line_number":15,"context_line":"      Next steps"},{"line_number":16,"context_line":"      Appendices"},{"line_number":17,"context_line":"    Release notes"},{"line_number":18,"context_line":"    Operations Guide"},{"line_number":19,"context_line":"      Verify OpenStack-Helm"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_d793abff","line":16,"range":{"start_line":8,"start_character":0,"end_line":16,"end_character":16},"updated":"2019-02-06 09:14:58.000000000","message":"I recognise that pattern ;)\n\nIt\u0027s been tremendously helpful for our contributors.\n\nSadly I think this should be in a different \"document\" as this needs to be published into a separate location.\n\nAlthough, this documentation is a unique repo for all osh docs, which makes it... unique compared to OSA for example.\n\nDid you speak with docs about using the same folder for deployment guides and for the rest of the documentation?","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":14,"context_line":"      Verify OpenStack-Helm"},{"line_number":15,"context_line":"      Next steps"},{"line_number":16,"context_line":"      Appendices"},{"line_number":17,"context_line":"    Release notes"},{"line_number":18,"context_line":"    Operations Guide"},{"line_number":19,"context_line":"      Verify OpenStack-Helm"},{"line_number":20,"context_line":"      Managing OpenStack-Helm"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_d7bc0b6e","line":17,"range":{"start_line":17,"start_character":4,"end_line":17,"end_character":17},"updated":"2019-02-06 09:14:58.000000000","message":"If you are pushign this to be a unique document, I think Release notes should appear later.\n\n1) You explain how to deploy in prod\n2) You ask \"what are your next steps?\", and people will follow two stories, Operations or Developer.\n3) In operations, we should probably point to read the release notes. \n\nIn that case, you can push the release notes topic a little down on the Content list, as it will still be read in \"story\" like content, and won\u0027t scare people.\n\nI would put it at last item in fact, as it makes sense to have this close to \"Reference\".","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":23928,"name":"Pete Birley","email":"petebirley@gmail.com","username":"portdirect"},"change_message_id":"58110f40539cb0dafeb231810f2f22595965d205","unresolved":false,"context_lines":[{"line_number":14,"context_line":"      Verify OpenStack-Helm"},{"line_number":15,"context_line":"      Next steps"},{"line_number":16,"context_line":"      Appendices"},{"line_number":17,"context_line":"    Release notes"},{"line_number":18,"context_line":"    Operations Guide"},{"line_number":19,"context_line":"      Verify OpenStack-Helm"},{"line_number":20,"context_line":"      Managing OpenStack-Helm"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_c3a8cddc","line":17,"range":{"start_line":17,"start_character":4,"end_line":17,"end_character":17},"in_reply_to":"9fdfeff1_d7bc0b6e","updated":"2019-02-06 13:33:34.000000000","message":"this is a good point, i\u0027ll move it down.","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":15,"context_line":"      Next steps"},{"line_number":16,"context_line":"      Appendices"},{"line_number":17,"context_line":"    Release notes"},{"line_number":18,"context_line":"    Operations Guide"},{"line_number":19,"context_line":"      Verify OpenStack-Helm"},{"line_number":20,"context_line":"      Managing OpenStack-Helm"},{"line_number":21,"context_line":"      Maintenance tasks"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_97b6838a","line":18,"range":{"start_line":18,"start_character":5,"end_line":18,"end_character":20},"updated":"2019-02-06 09:14:58.000000000","message":"This looks to map \"Admin\" guide of the docs guidelines quite well, where did you get that? ;)","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":23928,"name":"Pete Birley","email":"petebirley@gmail.com","username":"portdirect"},"change_message_id":"58110f40539cb0dafeb231810f2f22595965d205","unresolved":false,"context_lines":[{"line_number":15,"context_line":"      Next steps"},{"line_number":16,"context_line":"      Appendices"},{"line_number":17,"context_line":"    Release notes"},{"line_number":18,"context_line":"    Operations Guide"},{"line_number":19,"context_line":"      Verify OpenStack-Helm"},{"line_number":20,"context_line":"      Managing OpenStack-Helm"},{"line_number":21,"context_line":"      Maintenance tasks"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_43b4dd35","line":18,"range":{"start_line":18,"start_character":5,"end_line":18,"end_character":20},"in_reply_to":"9fdfeff1_97b6838a","updated":"2019-02-06 13:33:34.000000000","message":"this is shamelessly lifted from other well-established OpenStack deployment projects - as doing so both use the experience they offer but also allows people to simply make a decision as to which one may better suit their needs when performing evaluation of the different toolsets","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":27,"context_line":"        Version Philosophy (sugar cubes)"},{"line_number":28,"context_line":"        Minor version upgrade"},{"line_number":29,"context_line":"        Major upgrades"},{"line_number":30,"context_line":"    User Guide"},{"line_number":31,"context_line":"      All-In-One Quickstart"},{"line_number":32,"context_line":"      Test environment example"},{"line_number":33,"context_line":"      Production environment notes"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_57b01b8c","line":30,"range":{"start_line":30,"start_character":0,"end_line":30,"end_character":14},"updated":"2019-02-06 09:14:58.000000000","message":"This seems to map to \"user\" guides, which is fine for me.","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":31,"context_line":"      All-In-One Quickstart"},{"line_number":32,"context_line":"      Test environment example"},{"line_number":33,"context_line":"      Production environment notes"},{"line_number":34,"context_line":"    Developer Documentation"},{"line_number":35,"context_line":"      Project Onboarding"},{"line_number":36,"context_line":"        Project repositories"},{"line_number":37,"context_line":"        How to contribute on code or issues"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_17aa9318","line":34,"range":{"start_line":34,"start_character":0,"end_line":34,"end_character":27},"updated":"2019-02-06 09:14:58.000000000","message":"Fine for the mapping to dev.","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":23928,"name":"Pete Birley","email":"petebirley@gmail.com","username":"portdirect"},"change_message_id":"58110f40539cb0dafeb231810f2f22595965d205","unresolved":false,"context_lines":[{"line_number":31,"context_line":"      All-In-One Quickstart"},{"line_number":32,"context_line":"      Test environment example"},{"line_number":33,"context_line":"      Production environment notes"},{"line_number":34,"context_line":"    Developer Documentation"},{"line_number":35,"context_line":"      Project Onboarding"},{"line_number":36,"context_line":"        Project repositories"},{"line_number":37,"context_line":"        How to contribute on code or issues"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_2362f9d9","line":34,"range":{"start_line":34,"start_character":0,"end_line":34,"end_character":27},"in_reply_to":"9fdfeff1_17aa9318","updated":"2019-02-06 13:33:34.000000000","message":"we also need to add a section covering helm-toolkit, and how to use it.","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"},{"author":{"_account_id":17068,"name":"Jean-Philippe Evrard","email":"openstack@a.spamming.party","username":"evrardjp"},"change_message_id":"be69b49c90806886f88025f64be0e08b2b532739","unresolved":false,"context_lines":[{"line_number":64,"context_line":"        Minimum requirements for OpenStack-Helm charts"},{"line_number":65,"context_line":"        Graduation"},{"line_number":66,"context_line":"        Voting"},{"line_number":67,"context_line":""},{"line_number":68,"context_line":""},{"line_number":69,"context_line":"Indices and tables"},{"line_number":70,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9fdfeff1_7772ffe5","line":67,"updated":"2019-02-06 09:14:58.000000000","message":"I think you could add a \"Reference\" section here, where we explain how the internals of OSH are handled.\n\nHere are a few things we can speak about:\n- why helm charts\n- why not aggregating helm charts together in a release\n- project manifesto\n- What is helm toolkit, how it works, why we need it\n- What is kubernetes-entrypoints, how it works, why we need it","commit_id":"43c8af4fc1f6e078f63378f472d279daccb29b69"}]}
