diff --git a/docs/source/contributeaction.rst b/docs/source/contributeaction.rst new file mode 100644 index 0000000..7ea02a9 --- /dev/null +++ b/docs/source/contributeaction.rst @@ -0,0 +1,61 @@ +The Concore Action +================== + +Introduction +------------ +This feature makes it easy for users to share their studies, examples, and program files. With this feature, you can contribute your work without having to use GitHub. + + +How to use? +----------- + +Using concore editor: + +- Open **concore editor** by clicking on https://controlcore-project.github.io/concore-editor/ + +- Click on ``Contribute`` button at top-right of the editor + +- To contribute examples, concore fri(server) needs to be switched on. To do so refer https://control-core.readthedocs.io/en/latest/concoreeditor.html#how-to-use + +- Fill in the details as follow:- + These are the necessary arguments + - Study Name - title of the study + - Study Path - full directory path where the study is located as shown below. + - Author Name - name of the person who created that study + + You can also provide the options arguments by clicking ``Show Advance Options`` button + - Branch Name - the branch name you want + - Title of Study - a short title which will displayed as title of pull request at github + - Description of Study - a description which will be displayed as body of the pull request at github + + +``Note: If you are not familiar with Github, we recommend you to skip the optional fields`` + +.. image:: images/ce-contribute.png + :width: 700 + +- Click on ``Generate PR`` button and wait until it processes your request + +.. image:: images/ce-contribute-loading.png + :width: 700 + +- After it gets completed, you can check at the link given in the message + +.. image:: images/ce-contribute-success.png + :width: 700 + + +``Note: Successful submission doesnot mean that your study is added to our repository, It will take time for us to review and accept the study.So, you can mention your email in the description field mentioned above so that if your study got accepted then we will let you know.`` + + +Using command-line tools: + +- pass the above mentioned arguments to the ``contribute`` command + +``./contribute `` + +- e.g: + +``./contribute heart F:\example parteek heart-study "Added heart study"`` + +It will create a Pull request authored by parteek, on a new branch named heart-study with title "Added heart study" \ No newline at end of file diff --git a/docs/source/images/ce-contribute-loading.png b/docs/source/images/ce-contribute-loading.png new file mode 100644 index 0000000..835e79e Binary files /dev/null and b/docs/source/images/ce-contribute-loading.png differ diff --git a/docs/source/images/ce-contribute-success.png b/docs/source/images/ce-contribute-success.png new file mode 100644 index 0000000..04a3c25 Binary files /dev/null and b/docs/source/images/ce-contribute-success.png differ diff --git a/docs/source/images/ce-contribute.png b/docs/source/images/ce-contribute.png new file mode 100644 index 0000000..ab51c91 Binary files /dev/null and b/docs/source/images/ce-contribute.png differ diff --git a/docs/source/index.rst b/docs/source/index.rst index 3f7d2a0..ab0728e 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -24,4 +24,5 @@ Contents usage raspberrypi concoreeditor + contributeaction