Commit Graph

33 Commits

Author SHA1 Message Date
Zuul 7a82494061 Merge "Re-work the content under Practical Examples" 2021-09-07 18:37:30 +00:00
Zuul 5a5e6acd82 Merge "Polish the Introduction of the Four Opens book" 2021-09-07 18:37:29 +00:00
Ildiko Vancsa 25034fbf95 Re-work the content under Practical Examples
The previous patch moved out the action and examples from
under the Open Community chapter. This patch updates the text
to adjust to the content and flow of the book.

Change-Id: Ib4918697427c20c34a01c699e1741158b83bc7ec
Signed-off-by: Ildiko Vancsa <ildiko.vancsa@gmail.com>
2021-07-26 08:03:27 -07:00
Ildiko Vancsa 0f3e8f2a06 Polish the Introduction of the Four Opens book
The purpose of this patch is to edit the 'Introduction' section
of the Four Opens book. It is the first change of a series that
will go through the entire book to make the text read more neutral
and cohesive to make it ready to publish.

Change-Id: I7829fdfa3cca374032cc99cac4cc3479e694b877
Signed-off-by: Ildiko Vancsa <ildiko.vancsa@gmail.com>
2021-07-20 13:43:56 -07:00
Ildiko Vancsa 5db7e933c2 Restructuring body and text
This change restructures the body of the book to add an
additional chapter about actions and processes.

It also edits the chapters to create a more cohesive
flow and voice through the whole.

Change-Id: I31690e21ecc801e6c62cce57c5ed4174335bdc61
Signed-off-by: Ildiko Vancsa <ildiko.vancsa@gmail.com>
2021-04-06 15:49:06 +02:00
Trinh Nguyen 0bf814f232 Some edit to the Open Community document
Change-Id: Ie78cdb59690fecfb9e75973609198b77bd53c1a1
Signed-off-by: Trinh Nguyen <dangtrinhnt@gmail.com>
2019-07-17 16:45:16 +00:00
Zuul b5f5fe2524 Merge "Reword open design overview section" 2019-07-15 15:09:35 +00:00
Amy Marrich (spotz) ac65802b6e First edit of the Open Community section
Updated some wording and formatting.

Change-Id: I1c070f1f35b85bf507a690a89dd65633d0317691
2019-07-11 20:02:04 -05:00
Sean McGinnis ba8cfec5a5
Reword open design overview section
I found some of the phrasing a little awkward in the open design doc.
This is an attempt to clarify some of it and hopefully make it flow a
little better.

Change-Id: Iafb023b0f0a955abb2533cff16803461b99e30d4
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>
2019-07-10 15:25:17 -05:00
OpenDev Sysadmins 8e53db2cb4 OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
2019-04-19 19:25:32 +00:00
Andreas Jaeger 6c46a48c40 Small update for opendevelopment
Convert paragraph to a list, this looks like a formatting problem.

Add reference to the opencommunity chapter.

Change-Id: Ib342de96058a891a6e0999ee2e09a743b45001a3
2018-11-16 11:18:22 +01:00
Andreas Jaeger 83234fd752 Reorder sections
Use the same ordering in the index file as the governance repository
uses. This seems to have been the intented work flow as section
opendevelopment also speaks about next chapter opencommunity.

My initial creation of the index file gave here the wrong order.

Change-Id: Iaf225a36c22032c95667b540afdcacbf99125d73
2018-11-16 11:18:22 +01:00
Andreas Jaeger e9e55e91f5 Call document "The Four Opens"
Update sphinx configuration to use "The Four Opens" instead of "Four
Opens".

Change-Id: I29f1abe1839ef3d86640ba1a2ae982d027d0ad39
2018-11-16 11:18:22 +01:00
Andreas Jaeger eca2db19a5 Reformat opencommunity.rst
Add markup for headings and definition lists to better visualize the
structure of the document.

Change-Id: I89f1871643667eeed917b18431c99d85682cd737
2018-11-16 11:18:17 +01:00
Andreas Jaeger 30ef8472fa Enable linting
Enable linting with doc8 and fix all problems found so that it passes.

Change-Id: I052a1b8d016ae396917ae06c22ec29062aa10a2a
2018-11-14 17:23:22 +01:00
Andreas Jaeger 63d7a30840 Enable sphinx warnings
Tread warnings as errors - and fix all warnings.

Change-Id: I864fbc9cbe4a11c163505a10471dee869bcb1328
2018-11-14 17:18:38 +01:00
Andreas Jaeger b3bd57cf18 Adding test infrastructure
Setup repo for usual Sphinx location:
* content lives in doc/source
* Add tox.ini for building with linter and docs job
* Add doc/source/conf.py for Sphinx
* Add index file to build a manual
* Add jobs for Zuul; note that tox-linters is non-voting for now, fixing
  issues can be done as followup.
  The docs job has Sphinx warnings disabled, this will be a followup as
  well.
* Add .gitignore for usual build artefacts

Change-Id: Ie7af4b6bd661e61180528cc1ecf3076e3e95590b
2018-11-14 16:01:17 +01:00
Andreas Jaeger 1628efac16 Add noop-jobs
To be able to merge anything, we need some jobs. Add the noop-jobs that
don't test anything but allow merging.

Those can be replaced later with real jobs.

Change-Id: I29c16db4c5a9f7f0d2f2701554ed99efd3999b01
2018-11-14 15:39:53 +01:00
Chris Hoge b9c3be47f9
Merge pull request #1 from ttx/master
Changes from my draft review
2018-11-10 07:12:57 -08:00
Thierry Carrez 95d1f6969b Adding a line about publicly-accessible services
Open development also means everyone can see what is
happening without needing to sign up to anything.
2018-11-10 14:07:49 +01:00
Thierry Carrez a841541c44 Add details on feature vs time-based choice
You can do feature-based, but it's hard and you'll
do a bad job at it. Just embrace the benefits of time-based.
2018-11-10 14:03:38 +01:00
Thierry Carrez 87ddfba65b Not all OSF projects will use Apache-2
Add room for projects not using Apache-2, since the project
governance allows the board to approve other OSI-approved
licenses. This might lead us to further changes in that
section.
2018-11-10 13:58:27 +01:00
Thierry Carrez 9339c77d28 Bad idea not contributing back local changes
Add a paragraph about how it's a bad long-term strategy to
hold to local changes and not contributing them back upstream.
2018-11-10 13:57:40 +01:00
Thierry Carrez 0d901be790 Fix typos
Fix a couple of typos included in the initial upload.
2018-11-10 13:37:43 +01:00
Chris Hoge 4a7f43b086 Added .gitreview 2018-11-09 10:05:55 -08:00
Chris Hoge 0a930ba614 Open Community Section 2018-11-08 22:45:37 -08:00
Chris Hoge b07c46afb2 Added Open Development section 2018-11-06 16:24:16 -08:00
Chris Hoge bc8cc22e25 Open Design chapter 2018-11-06 16:10:53 -08:00
Chris Hoge bb24181a8d Add Open Source chapter 2018-11-06 15:58:32 -08:00
Chris Hoge 563230598f Fix footnotes 2018-11-06 15:34:58 -08:00
Chris Hoge 4e11847a90 Added introduction section 2018-11-06 15:27:30 -08:00
Chris Hoge 23eb3fd7d3 Update licence with copyright holder. 2018-11-06 15:08:51 -08:00
Chris Hoge 8d9a294829
Initial commit 2018-11-06 15:01:34 -08:00