d2dad1432c
# 🔍 Description ## Issue References 🔗 [Good First Issues](https://kyuubi.readthedocs.io/en/master/contributing/code/get_started.html) image links to the Github issues page while the image on [Contributing Documentation](https://kyuubi.readthedocs.io/en/master/contributing/doc/get_started.html) does not. ## Describe Your Solution 🔧 Added a link to https://github.com/apache/kyuubi/issues?q=is%3Aopen+is%3Aissue+label%3Akind%3Adocumentation to match the behaviour from good first issues ## Types of changes 🔖 - [ ] Bugfix (non-breaking change which fixes an issue) - [x] New feature (non-breaking change which adds functionality) - [ ] Breaking change (fix or feature that would cause existing functionality to change) ## Test Plan 🧪 #### Behavior Without This Pull Request ⚰️ #### Behavior With This Pull Request 🎉 #### Related Unit Tests --- # Checklist 📝 - [x] This patch was not authored or co-authored using [Generative Tooling](https://www.apache.org/legal/generative-tooling.html) **Be nice. Be informative.** Closes #6514 from artilexx/patch-1. Closes #6514 3d54ce982 [artilexx] Add link to github issues on documentation issues image Lead-authored-by: artilexx <arkhanlewis@gmail.com> Co-authored-by: artilexx <97213042+artilexx@users.noreply.github.com> Signed-off-by: Cheng Pan <chengpan@apache.org>
120 lines
4.1 KiB
ReStructuredText
120 lines
4.1 KiB
ReStructuredText
.. Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
.. http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
.. Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
|
|
Get Started
|
|
===========
|
|
|
|
.. image:: https://img.shields.io/github/issues/apache/kyuubi/kind:documentation?color=green&logo=gfi&logoColor=red&style=for-the-badge
|
|
:alt: GitHub issues by-label
|
|
:target: `Documentation Issues`_
|
|
|
|
|
|
Trivial Fixes
|
|
-------------
|
|
|
|
For typos, layout, grammar, spelling, punctuation errors and other similar issues
|
|
or changes that occur within a single file, it is acceptable to make edits directly
|
|
on the page being viewed. When viewing a source file on kyuubi's
|
|
`Github repository`_, a simple click on the ``edit icon`` or keyboard shortcut
|
|
``e`` will activate the editor. Similarly, when viewing files on `Read The Docs`_
|
|
platform, clicking on the ``suggest edit`` button will lead you to the editor.
|
|
These methods do not require any local development environment setup and
|
|
are convenient for making quick fixes.
|
|
|
|
Upon completion of the editing process, opt the ``commit changes`` option,
|
|
adhere to the provided instructions to submit a pull request,
|
|
and await feedback from the designated reviewer.
|
|
|
|
Major Fixes
|
|
-----------
|
|
|
|
For significant modifications that affect multiple files, it is advisable to
|
|
clone the repository to a local development environment, implement the necessary
|
|
changes, and conduct thorough testing prior to submitting a pull request.
|
|
|
|
|
|
`Fork`_ The Repository
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Clone The Forked Repository
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block::
|
|
:caption: Clone the repository
|
|
|
|
$ git clone https://github.com/your_username/kyuubi.git
|
|
|
|
Replace "your_username" with your GitHub username. This will create a local
|
|
copy of your forked repository on your machine. You will see the ``master``
|
|
branch if you run ``git branch`` in the ``kyuubi`` folder.
|
|
|
|
Create A New Branch
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block::
|
|
:caption: Create a new branch
|
|
|
|
$ git checkout -b guide
|
|
Switched to a new branch 'guide'
|
|
|
|
Editing And Testing
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
Make the necessary changes to the documentation files using a text editor.
|
|
`Build and verify`_ the changes you have made to see if they look fine.
|
|
|
|
.. note::
|
|
:class: dropdown, toggle
|
|
|
|
Create A Pull Request
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Once you have made the changes,
|
|
|
|
- Commit them with a descriptive commit message using the command:
|
|
|
|
.. code-block::
|
|
:caption: commit the changes
|
|
|
|
$ git commit -m "Description of changes made"
|
|
|
|
- Push the changes to your forked repository using the command
|
|
|
|
.. code-block::
|
|
:caption: push the changes
|
|
|
|
$ git push origin guide
|
|
|
|
- `Create A Pull Request`_ with a descriptive PR title and description.
|
|
|
|
- Polishing the PR with comments of reviews addressed
|
|
|
|
Report Only
|
|
-----------
|
|
|
|
If you don't have time to fix the doc issue and submit a pull request on your own,
|
|
`reporting a document issue`_ also helps. Please follow some basic rules:
|
|
|
|
- Use the title field to clearly describe the issue
|
|
- Choose the documentation report template
|
|
- Fill out the required field in the documentation report
|
|
|
|
.. _Home Page: https://kyuubi.apache.org
|
|
.. _Fork: https://github.com/apache/kyuubi/fork
|
|
.. _Build and verify: build.html
|
|
.. _Create A Pull Request: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request
|
|
.. _reporting a document issue: https://github.com/apache/kyuubi/issues/new/choose
|
|
.. _Documentation Issues: https://github.com/apache/kyuubi/issues?q=is%3Aopen+is%3Aissue+label%3Akind%3Adocumentation
|