update contribution docs

Author: jaimergp

README.md

@@ -10,20 +10,19 @@ If you have questions or need help, please check out our documentation for a [li
 
 ## Improving the docs
 
-- You can help to improve the documentation! It is version-controlled in the [conda-forge.github.io repository on GitHub](https://github.com/conda-forge/conda-forge.github.io).   The source text is stored in the `sphinx/src/` subdirectory and is formatted using Python’s [reStructuredText system](https://docutils.sourceforge.io/rst.html).
+- You can help to improve the documentation! It is version-controlled in the [conda-forge.github.io repository on GitHub](https://github.com/conda-forge/conda-forge.github.io).
 
 - The docs are built on GitHub Actions and run the `.ci_scripts/update_docs` script.
   We are glad to know that you would like to contribute. To build the docs locally, follow the steps mentioned below:
-1.  [Fork](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo) the [conda-forge.github.io](https://github.com/conda-forge/conda-forge.github.io)        repository to your own GitHub user account.
+
+1.  [Fork](https://docs.github.com/en/github/getting-started-with-github/fork-a-repo) the [conda-forge.github.io](https://github.com/conda-forge/conda-forge.github.io) repository to your own GitHub user account.
 2.  [Clone](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository) this fork onto your computer.
-3.  Go into the main folder. </br>
+3.  Go into the main folder.
     Run the following commands.  
       *  `conda env create -f ./.ci_scripts/environment.yml`
       *  `conda activate conda-forge-docs`
-      *  `cd sphinx`
-      *  `cd newsfeed && pip install --no-deps .`
-      *  `cd ../src`
-      *  `make html`
+      * For live builds, `npm install && npm run start`
+      * For production builds, run `.ci_scripts/update_docs`
 4.  Make and commit your changes.
 5.  Submit a [pull request](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests) to the main repository proposing your changes.
 

docs/user/contributing.md

@@ -56,12 +56,13 @@ If you are new to the conda-forge community, follow the steps below to make your
 4. Run the following commands:
    - `conda env create -f ./.ci_scripts/environment.yml`
    - `conda activate conda-forge-docs`
-   - `cd sphinx/src`
-5. Make your changes and run the following command to check them:
-   - `make html`
-
-   You can check the changes locally by opening the html files in `_build/html` or running:
-   - `python -m http.server --directory _build/html`
+5. While writing your new documentation, you can use the live preview mode with:
+   - `npm install` to make sure `node_modules` is up-to-date
+   - `npm run start` to start the live preview. Every time you save a file, the changes will be reflected instantaneously!
+5. Once ready, you can also check how the production build would look like with the command:
+   - `.ci_scripts/update_docs`
+   You can check the changes locally by opening the html files in `build/` or running:
+   - `python -m http.server --directory build/`
 6. Add and commit your changes:
    - `git add .`
    - `git commit -m "your commit message"`