From 0b41d0f226796ad0c4e95856a101240edf093553 Mon Sep 17 00:00:00 2001 From: Ned Batchelder Date: Tue, 24 Feb 2015 07:01:20 -0500 Subject: [PATCH] Convert README.md to README.rst --- README.md | 78 ---------------------------------------- README.rst | 103 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 103 insertions(+), 78 deletions(-) delete mode 100644 README.md create mode 100644 README.rst diff --git a/README.md b/README.md deleted file mode 100644 index 6ea0a2b4dd..0000000000 --- a/README.md +++ /dev/null @@ -1,78 +0,0 @@ -This is the main edX platform which consists of LMS and Studio. - -See [code.edx.org](http://code.edx.org/) for other parts of the edX code base. - -Installation ------------- - -Please refer to the following wiki pages in our [configuration repo](https://github.com/edx/configuration) to install edX: - -* [edX Developer Stack](https://github.com/edx/configuration/wiki/edX-Developer-Stack) -
These instructions are for developers who want to contribute or make changes to the edX source code. -* [edX Full Stack](https://github.com/edx/configuration/wiki/edX-Full-Stack) -
Using Vagrant/Virtualbox this will setup all edX services on a single server in a production like configuration. -* [edX Ubuntu 12.04 64-bit Installation](https://github.com/edx/configuration/wiki/edX-Ubuntu-12.04-64-bit-Installation) -
This will install edX on an existing Ubuntu 12.04 server. - - -License -------- - -The code in this repository is licensed under version 3 of the AGPL unless -otherwise noted. Please see the -[`LICENSE`](https://github.com/edx/edx-platform/blob/master/LICENSE) file -for details. - -Documentation -------------- - -Documentation for developers, researchers, and course staff is located in the -`docs` subdirectory. Documentation is built using -[Sphinx](http://sphinx-doc.org/): you can [view the built documentation on -ReadTheDocs](http://docs.edx.org/). - -Getting Help ------------- - -If you're having trouble, we have several different mailing lists where you can -ask for help: - -* [openedx-ops](https://groups.google.com/forum/#!forum/openedx-ops): - everything related to *running* Open edX. This includes - installation issues, server management, cost analysis, and so on. -* [openedx-translation](https://groups.google.com/forum/#!forum/openedx-translation): - everything related to *translating* Open edX into - other languages. This includes volunteer translators, our internationalization - infrastructure, issues related to Transifex, and so on. -* [openedx-analytics](https://groups.google.com/forum/#!forum/openedx-analytics): - everything related to *analytics* in Open edX. -* [edx-code](https://groups.google.com/forum/#!forum/edx-code): - everything related to the *code* in Open edX. This includes - feature requests, idea proposals, refactorings, and so on. - -You can also join our IRC channel: [`#edx-code` on Freenode](http://webchat.freenode.net/?channels=edx-code). - -Issue Tracker -------------- - -[We use JIRA for our issue tracker](https://openedx.atlassian.net/), not -GitHub Issues. To file a bug or request a new feature, please make a free -account on our JIRA and create a new issue! If you're filing a bug, -we'd appreciate it if you would follow -[our guidelines for filing high-quality, actionable bug reports](https://openedx.atlassian.net/wiki/display/SUST/How+to+File+a+Quality+Bug+Report). -Thanks! - -How to Contribute ------------------ - -Contributions are very welcome, but for legal reasons, you must submit a signed -[individual contributor's agreement](http://code.edx.org/individual-contributor-agreement.pdf) -before we can accept your contribution. See our -[CONTRIBUTING](https://github.com/edx/edx-platform/blob/master/CONTRIBUTING.rst) -file for more information -- it also contains guidelines for how to maintain -high code quality, which will make your contribution more likely to be accepted. - -Reporting Security Issues -------------------------- - -Please do not report security issues in public. Please email security@edx.org diff --git a/README.rst b/README.rst new file mode 100644 index 0000000000..ea96ad9d5b --- /dev/null +++ b/README.rst @@ -0,0 +1,103 @@ +This is the main edX platform which consists of LMS and Studio. + +See `code.edx.org`_ for other parts of the edX code base. + +.. _code.edx.org: http://code.edx.org/ + + +Installation +------------ + +Please refer to the following wiki pages in our `configuration repo`_ to +install edX: + +- `edX Developer Stack`_: These instructions are for developers who want + to contribute or make changes to the edX source code. +- `edX Full Stack`_: Using Vagrant/Virtualbox this will setup all edX + services on a single server in a production like configuration. +- `edX Ubuntu 12.04 64-bit Installation`_: This will install edX on an + existing Ubuntu 12.04 server. + +.. _configuration repo: https://github.com/edx/configuration +.. _edX Developer Stack: https://github.com/edx/configuration/wiki/edX-Developer-Stack +.. _edX Full Stack: https://github.com/edx/configuration/wiki/edX-Full-Stack +.. _edX Ubuntu 12.04 64-bit Installation: https://github.com/edx/configuration/wiki/edX-Ubuntu-12.04-64-bit-Installation + + +License +------- + +The code in this repository is licensed under version 3 of the AGPL +unless otherwise noted. Please see the `LICENSE`_ file for details. + +.. _LICENSE: https://github.com/edx/edx-platform/blob/master/LICENSE + + +Documentation +------------- + +Documentation for developers, researchers, and course staff is located +in the ``docs`` subdirectory. Documentation is built using `Sphinx`_: +you can `view the built documentation on ReadTheDocs`_. + +.. _Sphinx: http://sphinx-doc.org/ +.. _view the built documentation on ReadTheDocs: http://docs.edx.org/ + + +Getting Help +------------ + +If you’re having trouble, we have several different mailing lists where +you can ask for help: + +- `openedx-ops`_: everything related to *running* Open edX. This + includes installation issues, server management, cost analysis, and + so on. +- `openedx-translation`_: everything related to *translating* Open edX + into other languages. This includes volunteer translators, our + internationalization infrastructure, issues related to Transifex, and + so on. +- `openedx-analytics`_: everything related to *analytics* in Open edX. +- `edx-code`_: anything else related to Open edX. This includes feature + requests, idea proposals, refactorings, and so on. + +You can also join our IRC channel: `#edx-code on Freenode`_. + +.. _openedx-ops: https://groups.google.com/forum/#!forum/openedx-ops +.. _openedx-translation: https://groups.google.com/forum/#!forum/openedx-translation +.. _openedx-analytics: https://groups.google.com/forum/#!forum/openedx-analytics +.. _edx-code: https://groups.google.com/forum/#!forum/edx-code +.. _#edx-code on Freenode: http://webchat.freenode.net/?channels=edx-code + + +Issue Tracker +------------- + +`We use JIRA for our issue tracker`_, not GitHub Issues. To file a bug +or request a new feature, please make a free account on our JIRA and +create a new issue! If you’re filing a bug, we’d appreciate it if you +would follow `our guidelines for filing high-quality, actionable bug +reports`_. Thanks! + +.. _We use JIRA for our issue tracker: https://openedx.atlassian.net/ +.. _our guidelines for filing high-quality, actionable bug reports: https://openedx.atlassian.net/wiki/display/SUST/How+to+File+a+Quality+Bug+Report + + +How to Contribute +----------------- + +Contributions are very welcome, but for legal reasons, you must submit a +signed `individual contributor’s agreement`_ before we can accept your +contribution. See our `CONTRIBUTING`_ file for more information – it +also contains guidelines for how to maintain high code quality, which +will make your contribution more likely to be accepted. + + +Reporting Security Issues +------------------------- + +Please do not report security issues in public. Please email +security@edx.org + +.. _individual contributor’s agreement: http://code.edx.org/individual-contributor-agreement.pdf +.. _CONTRIBUTING: https://github.com/edx/edx-platform/blob/master/CONTRIBUTING.rst