)]}'
{"doc/source/contributor/CONTRIBUTING.rst":[{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":6,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"#. Our source code is hosted on `OpenDev Kolla Git"},{"line_number":9,"context_line":"   \u003chttps://opendev.org/openstack/kolla/\u003e`_. Bugs should be filed on"},{"line_number":10,"context_line":"   `launchpad \u003chttps://bugs.launchpad.net/kolla\u003e`_."},{"line_number":11,"context_line":""},{"line_number":12,"context_line":"#. Please follow OpenStack `Gerrit Workflow"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_92519234","side":"PARENT","line":9,"range":{"start_line":9,"start_character":4,"end_line":9,"end_character":40},"updated":"2020-02-21 11:03:13.000000000","message":"We don\u0027t mention where the source code is any more.","commit_id":"063a46a7de4471504535499ca2a972a79e4ce5e5"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":13,"context_line":"   \u003chttps://docs.openstack.org/infra/manual/developers.html#development-workflow\u003e`__"},{"line_number":14,"context_line":"   to contribute to Kolla."},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"#. Note the branch you\u0027re proposing changes to. ``master`` is the current focus"},{"line_number":17,"context_line":"   of development. Kolla project has a strict policy of only allowing backports"},{"line_number":18,"context_line":"   in ``stable/branch``, unless when not applicable. A bug in a"},{"line_number":19,"context_line":"   ``stable/branch`` will first have to be fixed in ``master``."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"#. Please file a `blueprint of kolla \u003chttps://blueprints.launchpad.net/kolla\u003e`__"},{"line_number":22,"context_line":"   for any significant code change and a bug"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_32369e03","side":"PARENT","line":19,"range":{"start_line":16,"start_character":0,"end_line":19,"end_character":63},"updated":"2020-02-21 11:03:13.000000000","message":"Seems like this is worth mentioning.","commit_id":"063a46a7de4471504535499ca2a972a79e4ce5e5"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":1,"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"},{"line_number":2,"context_line":"So You Want to Contribute..."},{"line_number":3,"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"},{"line_number":4,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_72741604","line":1,"updated":"2020-02-21 11:03:13.000000000","message":"Should we put this in the top-level of the repo, with a symlink here?","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":15197,"name":"Pierre Riteau","email":"pierre@stackhpc.com","username":"priteau","status":"StackHPC"},"change_message_id":"aaf75feb3227b28aad92a37f53e396663addff2c","unresolved":false,"context_lines":[{"line_number":1,"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"},{"line_number":2,"context_line":"So You Want to Contribute..."},{"line_number":3,"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"},{"line_number":4,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1fa4df85_312bb930","line":1,"in_reply_to":"3fa7e38b_72741604","updated":"2020-03-04 08:18:31.000000000","message":"The recommended approach is to have a short CONTRIBUTING.rst file at the top-level of the repo. See template at https://opendev.org/openstack/cookiecutter/src/branch/master/%7b%7bcookiecutter.repo_name%7d%7d/CONTRIBUTING.rst","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":7,"context_line":"It covers all the basics that are common to all OpenStack projects: the"},{"line_number":8,"context_line":"accounts you need, the basics of interacting with our Gerrit review system,"},{"line_number":9,"context_line":"how we communicate as a community, etc."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Below will cover the more project specific information you need to get started"},{"line_number":12,"context_line":"with Kolla."},{"line_number":13,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_f25fa675","line":10,"updated":"2020-02-21 11:03:13.000000000","message":"Cookiecutter also has:\n\nWe do NOT use Github for reviewing code, pull requests submitted there will be ignored.\n\nhttps://opendev.org/openstack/cookiecutter/src/branch/master/%7b%7bcookiecutter.repo_name%7d%7d/CONTRIBUTING.rst","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Below will cover the more project specific information you need to get started"},{"line_number":12,"context_line":"with Kolla."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Communication"},{"line_number":15,"context_line":"~~~~~~~~~~~~~~"},{"line_number":16,"context_line":".. This would be a good place to put the channel you chat in as a project; when/"},{"line_number":17,"context_line":"   where your meeting is, the tags you prepend to your ML threads, etc."}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_1297e2ec","line":14,"updated":"2020-02-21 11:03:13.000000000","message":"We have a wiki landing page tool, might as well link to it.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Communication"},{"line_number":15,"context_line":"~~~~~~~~~~~~~~"},{"line_number":16,"context_line":".. This would be a good place to put the channel you chat in as a project; when/"},{"line_number":17,"context_line":"   where your meeting is, the tags you prepend to your ML threads, etc."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"IRC Channel"},{"line_number":20,"context_line":"    ``#openstack-kolla`` (irclogs_)"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_12e2829d","line":17,"range":{"start_line":16,"start_character":0,"end_line":17,"end_character":71},"updated":"2020-02-21 11:03:13.000000000","message":"nit: don\u0027t need the comments.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":19,"context_line":"IRC Channel"},{"line_number":20,"context_line":"    ``#openstack-kolla`` (irclogs_)"},{"line_number":21,"context_line":""},{"line_number":22,"context_line":"Mailing list(prefix subjects with ``[kolla]``)"},{"line_number":23,"context_line":"    http://lists.openstack.org/pipermail/openstack-discuss/"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Weekly Meetings"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_32cc5e32","line":22,"range":{"start_line":22,"start_character":12,"end_line":22,"end_character":13},"updated":"2020-02-21 11:03:13.000000000","message":"nit: missing space","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":23,"context_line":"    http://lists.openstack.org/pipermail/openstack-discuss/"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Weekly Meetings"},{"line_number":26,"context_line":"    Bi-weekly, on Wednesdays at 08:00 UTC on odd weeks in the"},{"line_number":27,"context_line":"    ``#openstack-kolla`` IRC channel (`meetings logs`_)"},{"line_number":28,"context_line":""},{"line_number":29,"context_line":"Meeting Agenda"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_72ebb679","line":26,"range":{"start_line":26,"start_character":4,"end_line":26,"end_character":13},"updated":"2020-02-21 11:03:13.000000000","message":"Meetings are weekly at 1500 UTC","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":30,"context_line":"    https://wiki.openstack.org/wiki/Meetings/Kolla"},{"line_number":31,"context_line":""},{"line_number":32,"context_line":"Whiteboard"},{"line_number":33,"context_line":"    Keep track of CI gate status, release status, stable backports,"},{"line_number":34,"context_line":"    planning and feature development status."},{"line_number":35,"context_line":"    https://etherpad.openstack.org/p/KollaWhiteBoard"},{"line_number":36,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_b2f04e62","line":33,"range":{"start_line":33,"start_character":4,"end_line":33,"end_character":8},"updated":"2020-02-21 11:03:13.000000000","message":"nit: Keeps","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":41,"context_line":"~~~~~~~~~~~~~~~~~~~~~~~~~"},{"line_number":42,"context_line":".. This section should list the core team, their irc nicks, emails, timezones"},{"line_number":43,"context_line":"   etc. If all this info is maintained elsewhere (i.e. a wiki), you can link"},{"line_number":44,"context_line":"   to that instead of enumerating everyone here."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":47,"context_line":"| Name                  | IRC           | Email                              |"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_d2806aa0","line":44,"updated":"2020-02-21 11:03:13.000000000","message":"We do have this on the wiki, but I suppose it doesn\u0027t hurt to keep it here too.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":8556,"name":"Ghanshyam Maan","display_name":"Ghanshyam Maan","email":"gmaan.os14@gmail.com","username":"ghanshyam"},"change_message_id":"10471164d2ff6fb0a3d68ffd11ac6c95658d3d75","unresolved":false,"context_lines":[{"line_number":43,"context_line":"   etc. If all this info is maintained elsewhere (i.e. a wiki), you can link"},{"line_number":44,"context_line":"   to that instead of enumerating everyone here."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":47,"context_line":"| Name                  | IRC           | Email                              |"},{"line_number":48,"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\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":49,"context_line":"| `Christian Berendt`_  | berendt       | berendt@betacloud-solutions.de     |"},{"line_number":50,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":51,"context_line":"| `Dincer Celik`_       | osmanlicilegi | hello@dincercelik.com              |"},{"line_number":52,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":53,"context_line":"| `Eduardo Gonzalez`_   | egonzalez     | dabarren@gmail.com                 |"},{"line_number":54,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":55,"context_line":"| `Jeffrey Zhang`_      | Jeffrey4l     | jeffrey.zhang@99cloud.net          |"},{"line_number":56,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":57,"context_line":"| `Marcin Juszkiewicz`_ | hrw           | marcin.juszkiewicz@linaro.org      |"},{"line_number":58,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":59,"context_line":"| `Mark Goddard (PTL)`_ | mgoddard      | mark@stackhpc.com                  |"},{"line_number":60,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":61,"context_line":"| `Michal Nasiadka`_    | mnasiadka     | mnasiadka@gmail.com                |"},{"line_number":62,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":63,"context_line":"| `Radoslaw Piliszek`_  | yoctozepto    | radoslaw.piliszek@gmail.com        |"},{"line_number":64,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":65,"context_line":"| `Surya Prakash`_      | spsurya       | singh.surya64mnnit@gmail.com       |"},{"line_number":66,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":67,"context_line":"| `caoyuan`_            | caoyuan       | cao.yuan@99cloud.net               |"},{"line_number":68,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":69,"context_line":""},{"line_number":70,"context_line":".. _Christian Berendt: https://launchpad.net/~berendt"},{"line_number":71,"context_line":".. _Dincer Celik: https://launchpad.net/~osmanlicilegi"},{"line_number":72,"context_line":".. _Eduardo Gonzalez: https://launchpad.net/~egonzalez90"},{"line_number":73,"context_line":".. _Jeffrey Zhang: https://launchpad.net/~jeffrey4l"},{"line_number":74,"context_line":".. _Marcin Juszkiewicz: https://launchpad.net/~hrw"},{"line_number":75,"context_line":".. _Mark Goddard (PTL): https://launchpad.net/~mgoddard"},{"line_number":76,"context_line":".. _Michal Nasiadka: https://launchpad.net/~mnasiadka"},{"line_number":77,"context_line":".. _Radoslaw Piliszek: https://launchpad.net/~yoctozepto"},{"line_number":78,"context_line":".. _Surya Prakash: https://launchpad.net/~confisurya"},{"line_number":79,"context_line":".. _caoyuan: https://launchpad.net/~caoi-yuan"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"New Feature Planning"},{"line_number":82,"context_line":"~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1fa4df85_de506561","line":79,"range":{"start_line":46,"start_character":0,"end_line":79,"end_character":45},"updated":"2020-03-17 21:20:40.000000000","message":"this can go obsolete when changes in core group. You can give link of gerrit group here\n\nhttps://review.opendev.org/#/admin/groups/460,members","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":30491,"name":"Radosław Piliszek","display_name":"Radek","email":"radek@piliszek.it","username":"yoctozepto","status":"self-employed techologist, collaborating mostly with 7bulls.com"},"change_message_id":"673ab871dd080e058ed11bfb37d604e22967ba31","unresolved":false,"context_lines":[{"line_number":43,"context_line":"   etc. If all this info is maintained elsewhere (i.e. a wiki), you can link"},{"line_number":44,"context_line":"   to that instead of enumerating everyone here."},{"line_number":45,"context_line":""},{"line_number":46,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":47,"context_line":"| Name                  | IRC           | Email                              |"},{"line_number":48,"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\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":49,"context_line":"| `Christian Berendt`_  | berendt       | berendt@betacloud-solutions.de     |"},{"line_number":50,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":51,"context_line":"| `Dincer Celik`_       | osmanlicilegi | hello@dincercelik.com              |"},{"line_number":52,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":53,"context_line":"| `Eduardo Gonzalez`_   | egonzalez     | dabarren@gmail.com                 |"},{"line_number":54,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":55,"context_line":"| `Jeffrey Zhang`_      | Jeffrey4l     | jeffrey.zhang@99cloud.net          |"},{"line_number":56,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":57,"context_line":"| `Marcin Juszkiewicz`_ | hrw           | marcin.juszkiewicz@linaro.org      |"},{"line_number":58,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":59,"context_line":"| `Mark Goddard (PTL)`_ | mgoddard      | mark@stackhpc.com                  |"},{"line_number":60,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":61,"context_line":"| `Michal Nasiadka`_    | mnasiadka     | mnasiadka@gmail.com                |"},{"line_number":62,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":63,"context_line":"| `Radoslaw Piliszek`_  | yoctozepto    | radoslaw.piliszek@gmail.com        |"},{"line_number":64,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":65,"context_line":"| `Surya Prakash`_      | spsurya       | singh.surya64mnnit@gmail.com       |"},{"line_number":66,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":67,"context_line":"| `caoyuan`_            | caoyuan       | cao.yuan@99cloud.net               |"},{"line_number":68,"context_line":"+-----------------------+---------------+------------------------------------+"},{"line_number":69,"context_line":""},{"line_number":70,"context_line":".. _Christian Berendt: https://launchpad.net/~berendt"},{"line_number":71,"context_line":".. _Dincer Celik: https://launchpad.net/~osmanlicilegi"},{"line_number":72,"context_line":".. _Eduardo Gonzalez: https://launchpad.net/~egonzalez90"},{"line_number":73,"context_line":".. _Jeffrey Zhang: https://launchpad.net/~jeffrey4l"},{"line_number":74,"context_line":".. _Marcin Juszkiewicz: https://launchpad.net/~hrw"},{"line_number":75,"context_line":".. _Mark Goddard (PTL): https://launchpad.net/~mgoddard"},{"line_number":76,"context_line":".. _Michal Nasiadka: https://launchpad.net/~mnasiadka"},{"line_number":77,"context_line":".. _Radoslaw Piliszek: https://launchpad.net/~yoctozepto"},{"line_number":78,"context_line":".. _Surya Prakash: https://launchpad.net/~confisurya"},{"line_number":79,"context_line":".. _caoyuan: https://launchpad.net/~caoi-yuan"},{"line_number":80,"context_line":""},{"line_number":81,"context_line":"New Feature Planning"},{"line_number":82,"context_line":"~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1fa4df85_aec69648","line":79,"range":{"start_line":46,"start_character":0,"end_line":79,"end_character":45},"in_reply_to":"1fa4df85_de506561","updated":"2020-03-18 08:50:24.000000000","message":"True, but we are missing IRC nicks and launchpad references this way. Better have procedure to keep both updated. Link is nice to have too.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":85,"context_line":"   stick to a strict schedule when selecting what new features will be reviewed"},{"line_number":86,"context_line":"   for a release."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"New feature will be discussed via IRC or ML (with [kolla] prefix)."},{"line_number":89,"context_line":"Kolla team uses blueprints in `Launchpad`_ to manage the new features."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Adding a new service"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_525b1a60","line":88,"range":{"start_line":88,"start_character":4,"end_line":88,"end_character":11},"updated":"2020-02-21 11:03:13.000000000","message":"nit: features","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":85,"context_line":"   stick to a strict schedule when selecting what new features will be reviewed"},{"line_number":86,"context_line":"   for a release."},{"line_number":87,"context_line":""},{"line_number":88,"context_line":"New feature will be discussed via IRC or ML (with [kolla] prefix)."},{"line_number":89,"context_line":"Kolla team uses blueprints in `Launchpad`_ to manage the new features."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Adding a new service"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_b29e0ef8","line":88,"range":{"start_line":88,"start_character":41,"end_line":88,"end_character":43},"updated":"2020-02-21 11:03:13.000000000","message":"nit: mailing list","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":88,"context_line":"New feature will be discussed via IRC or ML (with [kolla] prefix)."},{"line_number":89,"context_line":"Kolla team uses blueprints in `Launchpad`_ to manage the new features."},{"line_number":90,"context_line":""},{"line_number":91,"context_line":"Adding a new service"},{"line_number":92,"context_line":"~~~~~~~~~~~~~~~~~~~~"},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"Kolla aims to both containerise and deploy all services within the OpenStack"},{"line_number":95,"context_line":"ecosystem. This is a constantly moving target as the ecosystem grows, so these"},{"line_number":96,"context_line":"guidelines aim to help make adding a new service to Kolla a smooth experience."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"The image"},{"line_number":99,"context_line":"---------"},{"line_number":100,"context_line":""},{"line_number":101,"context_line":"Kolla follows `Best practices for writing Dockerfiles"},{"line_number":102,"context_line":"\u003chttps://docs.docker.com/engine/userguide/eng-image/dockerfile_best-practices/\u003e`__"},{"line_number":103,"context_line":"when designing and implementing services where at all possible."},{"line_number":104,"context_line":""},{"line_number":105,"context_line":"We use ``jinja2`` templating syntax to help manage the volume and complexity"},{"line_number":106,"context_line":"that comes with maintaining multiple Dockerfiles for multiple different base"},{"line_number":107,"context_line":"operating systems."},{"line_number":108,"context_line":""},{"line_number":109,"context_line":"Images should be created under the ``docker`` directory. OpenStack services"},{"line_number":110,"context_line":"should inherit from the provided ``openstack-base`` image, while supporting and"},{"line_number":111,"context_line":"infrastructure services (for example, mongodb) should inherit from ``base``."},{"line_number":112,"context_line":""},{"line_number":113,"context_line":"Services consisting of only one service should be placed in an image named the"},{"line_number":114,"context_line":"same as that service, for example, ``horizon``. Services that consist of"},{"line_number":115,"context_line":"multiple processes generally use a base image and child images, for example,"},{"line_number":116,"context_line":"``glance-base``, ``glance-api``, and ``glance-registry``."},{"line_number":117,"context_line":""},{"line_number":118,"context_line":"Jinja2 \u0027blocks\u0027 are employed throughout the Dockerfile\u0027s to help operators"},{"line_number":119,"context_line":"customise various stages of the build (refer to :ref:`Dockerfile Customisation"},{"line_number":120,"context_line":"\u003cdockerfile-customisation\u003e`)"},{"line_number":121,"context_line":""},{"line_number":122,"context_line":"Some of these blocks are free form however, there are a subset that should be"},{"line_number":123,"context_line":"common to every Dockerfile. The overall structure for a multi container service"},{"line_number":124,"context_line":"is as follows:"},{"line_number":125,"context_line":""},{"line_number":126,"context_line":".. code-block:: console"},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"   FROM {{ namespace }}/{{ image_prefix }}openstack-base:{{ tag }}"},{"line_number":129,"context_line":"   LABEL maintainer\u003d\"{{ maintainer }}\" name\u003d\"{{ image_name }}\" build-date\u003d\"{{ build_date }}\""},{"line_number":130,"context_line":""},{"line_number":131,"context_line":"   {% block \u003c\u003c service \u003e\u003e_header %}{% endblock %}"},{"line_number":132,"context_line":""},{"line_number":133,"context_line":"   {% import \"macros.j2\" as macros with context %}"},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"   \u003c\u003c binary specific steps \u003e\u003e"},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"   \u003c\u003c source specific steps \u003e\u003e"},{"line_number":138,"context_line":""},{"line_number":139,"context_line":"   \u003c\u003c common steps \u003e\u003e"},{"line_number":140,"context_line":""},{"line_number":141,"context_line":"   {% block \u003c\u003c service \u003e\u003e_footer %}{% endblock %}"},{"line_number":142,"context_line":"   {% block footer %}{% endblock %}"},{"line_number":143,"context_line":""},{"line_number":144,"context_line":".. note::"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"   The generic footer block ``{% block footer %}{% endblock %}`` should not be"},{"line_number":147,"context_line":"   included in base images (for example, glance-base)."},{"line_number":148,"context_line":""},{"line_number":149,"context_line":".. _Launchpad: https://blueprints.launchpad.net/kolla"},{"line_number":150,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_3268def1","line":147,"range":{"start_line":91,"start_character":0,"end_line":147,"end_character":54},"updated":"2020-02-21 11:03:13.000000000","message":"Should we move this to a new page? It\u0027s getting quite into the weeds for a contributing page.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":154,"context_line":"   more than one launchpad project? what\u0027s the name of the project group"},{"line_number":155,"context_line":"   in storyboard?"},{"line_number":156,"context_line":""},{"line_number":157,"context_line":"We track our tasks in Launchpad"},{"line_number":158,"context_line":""},{"line_number":159,"context_line":"   https://bugs.launchpad.net/kolla"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_b2736ee5","line":157,"range":{"start_line":157,"start_character":13,"end_line":157,"end_character":18},"updated":"2020-02-21 11:03:13.000000000","message":"We don\u0027t really track tasks as such. Not sure what to put here.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":15197,"name":"Pierre Riteau","email":"pierre@stackhpc.com","username":"priteau","status":"StackHPC"},"change_message_id":"aaf75feb3227b28aad92a37f53e396663addff2c","unresolved":false,"context_lines":[{"line_number":154,"context_line":"   more than one launchpad project? what\u0027s the name of the project group"},{"line_number":155,"context_line":"   in storyboard?"},{"line_number":156,"context_line":""},{"line_number":157,"context_line":"We track our tasks in Launchpad"},{"line_number":158,"context_line":""},{"line_number":159,"context_line":"   https://bugs.launchpad.net/kolla"},{"line_number":160,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"1fa4df85_f1e5210a","line":157,"range":{"start_line":157,"start_character":13,"end_line":157,"end_character":18},"in_reply_to":"3fa7e38b_b2736ee5","updated":"2020-03-04 08:18:31.000000000","message":"Link to Kolla whiteboard? It links to planning documents, priorities, etc.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":164,"context_line":"   your project."},{"line_number":165,"context_line":""},{"line_number":166,"context_line":"You found an issue and want to make sure we are aware of it? You can do so"},{"line_number":167,"context_line":"`HERE`_."},{"line_number":168,"context_line":""},{"line_number":169,"context_line":".. _HERE: https://bugs.launchpad.net/kolla"},{"line_number":170,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_52447a76","line":167,"range":{"start_line":167,"start_character":1,"end_line":167,"end_character":5},"updated":"2020-02-21 11:03:13.000000000","message":"nit: here","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":175,"context_line":"   test changes with all patches? etc."},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"All changes proposed to Kolla require two +2 votes from core reviewers before"},{"line_number":178,"context_line":"+W. We also require a release note on most changes, Kolla uses the following"},{"line_number":179,"context_line":"release notes sections:"},{"line_number":180,"context_line":""},{"line_number":181,"context_line":"- ``features`` --- for new features or functionality; these should ideally"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_f2000607","line":178,"updated":"2020-02-21 11:03:13.000000000","message":"Let\u0027s also state that significant features should be documented and tested.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":176,"context_line":""},{"line_number":177,"context_line":"All changes proposed to Kolla require two +2 votes from core reviewers before"},{"line_number":178,"context_line":"+W. We also require a release note on most changes, Kolla uses the following"},{"line_number":179,"context_line":"release notes sections:"},{"line_number":180,"context_line":""},{"line_number":181,"context_line":"- ``features`` --- for new features or functionality; these should ideally"},{"line_number":182,"context_line":"  refer to the blueprint being implemented;"}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_cd0a0f1e","line":179,"updated":"2020-02-21 11:03:13.000000000","message":"Could we have a subsection for release notes?","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"},{"author":{"_account_id":14826,"name":"Mark Goddard","email":"markgoddard86@gmail.com","username":"mgoddard"},"change_message_id":"a060b5953176c3ce00b2b5d25a43707eb3c1ffee","unresolved":false,"context_lines":[{"line_number":217,"context_line":"have to at least add it to the ``git``\u0027s staging area."},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"Project Team Lead Duties"},{"line_number":220,"context_line":"------------------------"},{"line_number":221,"context_line":".. this section is where you can put PTL specific duties not already listed in"},{"line_number":222,"context_line":"   the common PTL guide (linked below)  or if you already have them written"},{"line_number":223,"context_line":"   up elsewhere, you can link to that doc here."}],"source_content_type":"text/x-rst","patch_set":2,"id":"3fa7e38b_2d040313","line":220,"range":{"start_line":220,"start_character":0,"end_line":220,"end_character":24},"updated":"2020-02-21 11:03:13.000000000","message":"This renders as a subsection of the above which doesn\u0027t look right.","commit_id":"06673211fe1655f7931de35400f0164f2fc7ba6b"}],"doc/source/contributor/adding-a-new-image.rst":[{"author":{"_account_id":24072,"name":"Marcin Juszkiewicz","email":"mjuszkiewicz@redhat.com","username":"hrw"},"change_message_id":"5f1291c8a43da5ec69ab252d448f1579b08b3f96","unresolved":false,"context_lines":[{"line_number":31,"context_line":".. code-block:: console"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"   FROM {{ namespace }}/{{ image_prefix }}openstack-base:{{ tag }}"},{"line_number":34,"context_line":"   LABEL maintainer\u003d\"{{ maintainer }}\" name\u003d\"{{ image_name }}\" build-date\u003d\"{{ build_date }}\""},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"   {% block \u003c\u003c service \u003e\u003e_header %}{% endblock %}"},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ff570b3c_cc4eb295","line":34,"range":{"start_line":34,"start_character":3,"end_line":34,"end_character":8},"updated":"2020-05-20 15:36:55.000000000","message":"we have a block around LABEL nowadays","commit_id":"f3f471b41e6702d30ff45b4fb25b8b84bb030b52"},{"author":{"_account_id":30491,"name":"Radosław Piliszek","display_name":"Radek","email":"radek@piliszek.it","username":"yoctozepto","status":"self-employed techologist, collaborating mostly with 7bulls.com"},"change_message_id":"4477222bc990c0022e68f26b6b84c338741ce6b1","unresolved":false,"context_lines":[{"line_number":31,"context_line":".. code-block:: console"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"   FROM {{ namespace }}/{{ image_prefix }}openstack-base:{{ tag }}"},{"line_number":34,"context_line":"   LABEL maintainer\u003d\"{{ maintainer }}\" name\u003d\"{{ image_name }}\" build-date\u003d\"{{ build_date }}\""},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"   {% block \u003c\u003c service \u003e\u003e_header %}{% endblock %}"},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ff570b3c_c201566c","line":34,"range":{"start_line":34,"start_character":3,"end_line":34,"end_character":8},"in_reply_to":"ff570b3c_cc4eb295","updated":"2020-05-20 18:01:54.000000000","message":"good one, will do followup","commit_id":"f3f471b41e6702d30ff45b4fb25b8b84bb030b52"}]}