Skip to content

Kan-T-IT/geonode_cloud_documentation

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Geonode Cloud - Documentation

Contributing to the Documentation

If you would like to contribute to the documentation , you can follow these steps:

Prerequisites using Linux Terminal

Before contributing, ensure that you have the necessary tools and dependencies set up on your system.

  1. Clone the repository to your local machine:

    git clone https://github.com/Kan-T-IT/geonode_cloud_documentation
  2. Set up a virtual environment and install the required dependencies:

    virtualenv -p python3.10 env3
    source env3/bin/activate
    pip install mkdocs-material

Contributing Process

Once you have the environment configured, you can start contributing to the documentation.

  1. Navigate to the project directory:

    cd geonode_cloud_documentation
  2. Make the desired changes to the documentation using your preferred text editor.

  3. Preview your changes locally by running:

    mkdocs serve

    This command will start a local server that allows you to view the documentation with your changes in your web browser. The server will provide you with a local URL (usually http://127.0.0.1:8000) to access the documentation.

  4. Review your changes in the browser to ensure they look as expected. Make any necessary adjustments.

  5. Once you are satisfied with your changes, commit your edits to your local Git repository:

    git add .
    git commit -m "Added/Updated documentation on [Your Contribution]"
  6. Push your changes to your fork of the repository:

    git push origin main
  7. Create a pull request (PR) to submit your changes to the original project repository.

Prerequisites using Docker Compose

Before contributing, make sure you have the necessary tools and dependencies set up on your system.

  1. Last version Docker
  2. Last version Docker Compose

Contributing Process

Once you have the environment configured, you can begin contributing to the documentation.

  1. Clone the repository to your local machine:

    git clone https://github.com/Kan-T-IT/geonode_cloud_documentation
  2. Navigate to the project directory:

    cd geonode_cloud_documentation
  3. Run the following command in the console:

    docker-compose -d up
  4. Make the desired changes to the documentation using your preferred editor.

  5. Preview your changes locally by running. The server will provide you with a local URL (usually http://127.0.0.1:8000) to access the documentation.

  6. Review your changes in the browser to ensure they look as expected. Make any necessary adjustments.

  7. Once you are satisfied with your changes, commit your edits to your local Git repository:

    git add .
    git commit -m "Added/Updated documentation on [Your Contribution]"
  8. Push your changes to your fork of the repository:

    git push origin main
  9. Create a pull request (PR) to submit your changes to the original project repository.

Review and Acceptance

After you create a pull request, the project maintainers will review your contribution. If everything is in order, they will merge your changes into the main documentation. Thank you for contributing to documentation!!