Update README for Clarity and Comprehension

README.md

@@ -1,20 +1,10 @@
 ## nx-parallel
 
-A NetworkX backend plugin which uses joblib and multiprocessing for parallelization.
+nx-parallel is a NetworkX backend plugin that uses joblib and multiprocessing for parallelization. This project aims to provide parallelized implementations of various NetworkX functions to improve performance.
 
-```python
-In [1]: import networkx as nx; import nx_parallel
+## Features
 
-In [2]: G = nx.path_graph(4)
-
-In [3]: H = nx_parallel.ParallelGraph(G)
-
-In [4]: nx.betweenness_centrality(H)
-Out[4]: {0: 0.0, 1: 0.6666666666666666, 2: 0.6666666666666666, 3: 0.0}
-
-```
-
-Currently the following functions have parallelized implementations:
+nx-parallel provides parallelized implementations for the following NetworkX functions:
 
 ```
 ├── centrality
@@ -38,21 +28,52 @@ To setup a local development:
 - Fork this repository.
 - Clone the forked repository locally.
 ```
-$ git clone git@github.com:<your_username>/networkx.git
+git clone git@github.com:<your_username>/networkx.git
 ```
 - Create a fresh conda/mamba virtualenv and install the dependencies
 ```
-$ pip install -e ".[developer]"
+pip install -e ".[developer]"
 ```
 - Install pre-commit actions that will run the linters before making a commit
 ```
-$ pre-commit install
+pre-commit install
+```
+
+
+## Usage
+
+Here's an example of how to use nx-parallel:
+
+```python
+In [1]: import networkx as nx; import nx_parallel
+
+In [2]: G = nx.path_graph(4)
+
+In [3]: H = nx_parallel.ParallelGraph(G)
+
+In [4]: nx.betweenness_centrality(H)
+Out[4]: {0: 0.0, 1: 0.6666666666666666, 2: 0.6666666666666666, 3: 0.0}
 ```
-- Make sure you can run the tests locally with
+
+## Testing
+
+To run tests for the project, use the following command:
+
 ```
 PYTHONPATH=. \
 NETWORKX_GRAPH_CONVERT=parallel \
 NETWORKX_TEST_BACKEND=parallel \
 NETWORKX_FALLBACK_TO_NX=True \
     pytest --pyargs networkx "$@"
-```
+```
+
+## Contributing
+
+We'd love to have you contribute to nx-parallel! Here are some guidelines on how to do that:
+
+- **Issues:** Feel free to open issues for any problems you face, or for new features you'd like to see implemented.
+- **Pull requests:** If you'd like to implement a feature or fix a bug yourself, we'd be happy to review a pull request. Please make sure to explain the changes you made in the pull request description.
+
+## Additional Information
+
+This project is part of the larger NetworkX project. If you're interested in contributing to NetworkX, you can find more information in the [NetworkX contributing guidelines](https://github.com/networkx/networkx/blob/main/CONTRIBUTING.rst).