From aaccf08fe31c08a5f89bd9a6bafb69b808d91419 Mon Sep 17 00:00:00 2001 From: yozachar <38415384+yozachar@users.noreply.github.com> Date: Fri, 19 Apr 2024 13:35:44 +0530 Subject: [PATCH 1/2] chore: adds contribution guidelines --- CONTRIBUTING.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..6307a603 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,35 @@ +# How to contribute to `validators` + +Hi, to start, you need the following installed on your system. + +1. [Git](https://git-scm.com/) +2. [Python](https://www.python.org/) v3.8 or later and +3. [PDM](https://pdm-project.org/en/stable/) for easy dependency management. +4. (Optional/Recommended) NodeJS for type checking. +5. (Optional/Recommended) [mise](https://github.com/jdx/mise) to manage multiple versions of Python, NodeJS etc. + + +First [fork](https://github.com/python-validators/validators/fork) this repository. Then clone it to your system. Then install development dependencies. + + +```sh +# cloning repository +$ git clone "https://github.com/YOUR_USERNAME/validators.git" +# changing directory +$ cd validators +# installing development dependencies +$ pdm install +``` + +Activate the virtual environment and run `tox` to verify test cases. + +```sh +# activate virtual environment +$ . ./.venv/bin/activate # replace `/bin/` with `/Scripts/` if you're on Windows. +# run tox for linting, type checking, formatting etc. +$ tox +``` + +Create a git branch. You can now make changes to the source code. If needed, test your change by running `pytest`. Commit, push and create a pull request. + +If you're in doubt feel free to start a discussion [here](https://github.com/python-validators/validators/discussions). Thanks for taking interest in this library. From 54917a0df8806983e50ca60fed94f0df88bb9a09 Mon Sep 17 00:00:00 2001 From: yozachar <38415384+yozachar@users.noreply.github.com> Date: Fri, 19 Apr 2024 15:32:02 +0530 Subject: [PATCH 2/2] fix: use backup url from documentation --- README.md | 4 ++-- docs/index.md | 4 ++-- docs/index.rst | 4 ++-- mkdocs.yaml | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index c1baed3f..9bc68517 100644 --- a/README.md +++ b/README.md @@ -18,10 +18,10 @@ True ## Resources - + -- [Documentation](https://python-validators.github.io/validators/) +- [Documentation](https://yozachar.github.io/pyvalidators) - [Bugtracker](https://github.com/python-validators/validators/issues) - [Security](https://github.com/python-validators/validators/blob/master/SECURITY.md) - [Code](https://github.com/python-validators/validators/) diff --git a/docs/index.md b/docs/index.md index c1baed3f..9bc68517 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,10 +18,10 @@ True ## Resources - + -- [Documentation](https://python-validators.github.io/validators/) +- [Documentation](https://yozachar.github.io/pyvalidators) - [Bugtracker](https://github.com/python-validators/validators/issues) - [Security](https://github.com/python-validators/validators/blob/master/SECURITY.md) - [Code](https://github.com/python-validators/validators/) diff --git a/docs/index.rst b/docs/index.rst index fc10d612..0d4e84dd 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -24,13 +24,13 @@ Resources .. raw:: html - + .. raw:: html -- `Documentation `__ +- `Documentation `__ - `Bugtracker `__ - `Security `__ - `Code `__ diff --git a/mkdocs.yaml b/mkdocs.yaml index 968eb01b..cfa47f7d 100644 --- a/mkdocs.yaml +++ b/mkdocs.yaml @@ -1,7 +1,7 @@ site_name: "validators" site_description: "Automatic documentation from sources, for MkDocs." -site_url: "https://python-validators.github.io/validators/" -repo_url: "https://github.com/python-validators/validators" +site_url: "https://yozachar.github.io/pyvalidators/" +repo_url: "https://github.com/python-validators/validators/" edit_uri: "edit/master/docs/" repo_name: "validators/validators" site_dir: "site"