From 0600daebff7a568f902363cdc5685cbfc367b694 Mon Sep 17 00:00:00 2001 From: melissawm Date: Tue, 2 Aug 2022 18:08:09 -0300 Subject: [PATCH 1/5] Refactoring gitwash --- doc/devel/coding_guide.rst | 82 ++++++++- doc/devel/contributing.rst | 103 ++--------- doc/devel/development_setup.rst | 25 ++- .../{gitwash => }/development_workflow.rst | 135 ++++---------- doc/devel/gitwash/branch_dropdown.png | Bin 16311 -> 0 bytes doc/devel/gitwash/configure_git.rst | 172 ------------------ doc/devel/gitwash/dot2_dot3.rst | 28 --- doc/devel/gitwash/following_latest.rst | 38 ---- doc/devel/gitwash/forking_button.png | Bin 13092 -> 0 bytes doc/devel/gitwash/forking_hell.rst | 34 ---- doc/devel/gitwash/git_development.rst | 16 -- doc/devel/gitwash/git_install.rst | 28 --- doc/devel/gitwash/git_intro.rst | 20 -- doc/devel/gitwash/git_links.inc | 59 ------ doc/devel/gitwash/git_resources.rst | 59 ------ doc/devel/gitwash/index.rst | 19 -- doc/devel/gitwash/known_projects.inc | 41 ----- doc/devel/gitwash/links.inc | 4 - doc/devel/gitwash/patching.rst | 138 -------------- doc/devel/gitwash/pull_button.png | Bin 12893 -> 0 bytes doc/devel/gitwash/set_up_fork.rst | 68 ------- doc/devel/gitwash/this_project.inc | 5 - doc/devel/index.rst | 3 +- .../{gitwash => }/maintainer_workflow.rst | 4 +- 24 files changed, 158 insertions(+), 923 deletions(-) rename doc/devel/{gitwash => }/development_workflow.rst (73%) delete mode 100644 doc/devel/gitwash/branch_dropdown.png delete mode 100644 doc/devel/gitwash/configure_git.rst delete mode 100644 doc/devel/gitwash/dot2_dot3.rst delete mode 100644 doc/devel/gitwash/following_latest.rst delete mode 100644 doc/devel/gitwash/forking_button.png delete mode 100644 doc/devel/gitwash/forking_hell.rst delete mode 100644 doc/devel/gitwash/git_development.rst delete mode 100644 doc/devel/gitwash/git_install.rst delete mode 100644 doc/devel/gitwash/git_intro.rst delete mode 100644 doc/devel/gitwash/git_links.inc delete mode 100644 doc/devel/gitwash/git_resources.rst delete mode 100644 doc/devel/gitwash/index.rst delete mode 100644 doc/devel/gitwash/known_projects.inc delete mode 100644 doc/devel/gitwash/links.inc delete mode 100644 doc/devel/gitwash/patching.rst delete mode 100644 doc/devel/gitwash/pull_button.png delete mode 100644 doc/devel/gitwash/set_up_fork.rst delete mode 100644 doc/devel/gitwash/this_project.inc rename doc/devel/{gitwash => }/maintainer_workflow.rst (96%) diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst index 061af298efe2..f26d1d09db8a 100644 --- a/doc/devel/coding_guide.rst +++ b/doc/devel/coding_guide.rst @@ -13,9 +13,89 @@ Pull request guidelines *********************** -Pull requests (PRs) are the mechanism for contributing to Matplotlibs code and +Pull requests (PRs) are the mechanism for contributing to Matplotlib's code and documentation. +It is recommended to check that your contribution complies with the following +rules before submitting a pull request: + +* If your pull request addresses an issue, please use the title to describe the + issue and mention the issue number in the pull request description to ensure + that a link is created to the original issue. + +* All public methods should have informative docstrings with sample usage when + appropriate. Use the `numpy docstring standard + `_. + +* Formatting should follow the recommendations of PEP8_, as enforced by + flake8_. You can check flake8 compliance from the command line with :: + + python -m pip install flake8 + flake8 /path/to/module.py + + or your editor may provide integration with it. Note that Matplotlib + intentionally does not use the black_ auto-formatter (1__), in particular due + to its unability to understand the semantics of mathematical expressions + (2__, 3__). + + .. _PEP8: https://www.python.org/dev/peps/pep-0008/ + .. _flake8: https://flake8.pycqa.org/ + .. _black: https://black.readthedocs.io/ + .. __: https://github.com/matplotlib/matplotlib/issues/18796 + .. __: https://github.com/psf/black/issues/148 + .. __: https://github.com/psf/black/issues/1984 + +* Each high-level plotting function should have a simple example in the + ``Example`` section of the docstring. This should be as simple as possible + to demonstrate the method. More complex examples should go in the + ``examples`` tree. + +* Changes (both new features and bugfixes) should have good test coverage. See + :ref:`testing` for more details. + +* Import the following modules using the standard scipy conventions:: + + import numpy as np + import numpy.ma as ma + import matplotlib as mpl + import matplotlib.pyplot as plt + import matplotlib.cbook as cbook + import matplotlib.patches as mpatches + + In general, Matplotlib modules should **not** import `.rcParams` using ``from + matplotlib import rcParams``, but rather access it as ``mpl.rcParams``. This + is because some modules are imported very early, before the `.rcParams` + singleton is constructed. + +* If your change is a major new feature, add an entry to the ``What's new`` + section by adding a new file in ``doc/users/next_whats_new`` (see + :file:`doc/users/next_whats_new/README.rst` for more information). + +* If you change the API in a backward-incompatible way, please document it in + :file:`doc/api/next_api_changes/behavior`, by adding a new file with the + naming convention ``99999-ABC.rst`` where the pull request number is followed + by the contributor's initials. (see :file:`doc/api/api_changes.rst` for more + information) + +* See below for additional points about :ref:`keyword-argument-processing`, if + applicable for your pull request. + +.. note:: + + The current state of the Matplotlib code base is not compliant with all + of those guidelines, but we expect that enforcing those constraints on all + new contributions will move the overall code base quality in the right + direction. + + +.. seealso:: + + * :ref:`coding_guidelines` + * :ref:`testing` + * :ref:`documenting-matplotlib` + + + Summary for pull request authors ================================ diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst index 6bd7f2610687..17a7e3e9dfe3 100644 --- a/doc/devel/contributing.rst +++ b/doc/devel/contributing.rst @@ -4,13 +4,20 @@ Contributing ============ +You've discovered a bug or something else you want to change +in Matplotlib — excellent! + +You've worked out a way to fix it — even better! + +You want to tell us about it — best of all! + This project is a community effort, and everyone is welcome to contribute. Everyone within the community is expected to abide by our `code of conduct `_. -The project is hosted on -https://github.com/matplotlib/matplotlib +Below, you can find a number of ways to contribute, and how to connect with the +Matplotlib community. Get Connected ============= @@ -192,96 +199,8 @@ A brief overview is: Finally, go to the web page of your fork of the Matplotlib repo, and click 'Pull request' to send your changes to the maintainers for review. -.. seealso:: - - * `Git documentation `_ - * `Git-Contributing to a Project `_ - * `Introduction to GitHub `_ - * :ref:`development-workflow` for best practices for Matplotlib - * :ref:`using-git` - -Contributing pull requests --------------------------- - -It is recommended to check that your contribution complies with the following -rules before submitting a pull request: - -* If your pull request addresses an issue, please use the title to describe the - issue and mention the issue number in the pull request description to ensure - that a link is created to the original issue. - -* All public methods should have informative docstrings with sample usage when - appropriate. Use the `numpy docstring standard - `_. - -* Formatting should follow the recommendations of PEP8_, as enforced by - flake8_. You can check flake8 compliance from the command line with :: - - python -m pip install flake8 - flake8 /path/to/module.py - - or your editor may provide integration with it. Note that Matplotlib - intentionally does not use the black_ auto-formatter (1__), in particular due - to its inability to understand the semantics of mathematical expressions - (2__, 3__). - - .. _PEP8: https://www.python.org/dev/peps/pep-0008/ - .. _flake8: https://flake8.pycqa.org/ - .. _black: https://black.readthedocs.io/ - .. __: https://github.com/matplotlib/matplotlib/issues/18796 - .. __: https://github.com/psf/black/issues/148 - .. __: https://github.com/psf/black/issues/1984 - -* Each high-level plotting function should have a simple example in the - ``Example`` section of the docstring. This should be as simple as possible - to demonstrate the method. More complex examples should go in the - ``examples`` tree. - -* Changes (both new features and bugfixes) should have good test coverage. See - :ref:`testing` for more details. - -* Import the following modules using the standard scipy conventions:: - - import numpy as np - import numpy.ma as ma - import matplotlib as mpl - import matplotlib.pyplot as plt - import matplotlib.cbook as cbook - import matplotlib.patches as mpatches - - In general, Matplotlib modules should **not** import `.rcParams` using ``from - matplotlib import rcParams``, but rather access it as ``mpl.rcParams``. This - is because some modules are imported very early, before the `.rcParams` - singleton is constructed. - -* If your change is a major new feature, add an entry to the ``What's new`` - section by adding a new file in ``doc/users/next_whats_new`` (see - :file:`doc/users/next_whats_new/README.rst` for more information). - -* If you change the API in a backward-incompatible way, please document it in - :file:`doc/api/next_api_changes/behavior`, by adding a new file with the - naming convention ``99999-ABC.rst`` where the pull request number is followed - by the contributor's initials. (see :file:`doc/api/api_changes.rst` for more - information) - -* See below for additional points about :ref:`keyword-argument-processing`, if - applicable for your pull request. - -.. note:: - - The current state of the Matplotlib code base is not compliant with all - of those guidelines, but we expect that enforcing those constraints on all - new contributions will move the overall code base quality in the right - direction. - - -.. seealso:: - - * :ref:`coding_guidelines` - * :ref:`testing` - * :ref:`documenting-matplotlib` - - +For more detailed instructions on how to set up Matplotlib for development and +best practices for contribution, see :ref:`installing_for_devs`. .. _contributing_documentation: diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst index 81939e2474dc..1e3017060d6a 100644 --- a/doc/devel/development_setup.rst +++ b/doc/devel/development_setup.rst @@ -15,7 +15,7 @@ Retrieve the latest version of the code Matplotlib is hosted at https://github.com/matplotlib/matplotlib.git. You can retrieve the latest sources with the command (see -:ref:`set-up-fork` for more details) +`the GitHub documentation `__ for more details):: .. tab-set:: @@ -69,6 +69,11 @@ The simplest way to do this is to use either Python's virtual environment \Scripts\activate.bat # Windows cmd.exe \Scripts\Activate.ps1 # Windows PowerShell +Conda dev environment +--------------------- + +After you have cloned the repo change into the matplotlib directory. + .. tab-item:: conda environment Create a new `conda`_ environment with :: @@ -86,12 +91,30 @@ The simplest way to do this is to use either Python's virtual environment Remember to activate the environment whenever you start working on Matplotlib. +<<<<<<< HEAD Install additional development dependencies =========================================== See :ref:`development-dependencies`. +======= +<<<<<<< HEAD +>>>>>>> e998d58f3c (Refactoring gitwash) Install Matplotlib in editable mode =================================== +======= +.. seealso:: + + * `Git documentation `_ + * `Git-Contributing to a Project `_ + * `Introduction to GitHub `_ + * :ref:`using-git` + * :ref:`git-resources` + * `Installing git `_ + + +Installing Matplotlib in editable mode +====================================== +>>>>>>> 0e759d3ee8 (Refactoring gitwash) Install Matplotlib in editable mode from the :file:`matplotlib` directory using the command :: diff --git a/doc/devel/gitwash/development_workflow.rst b/doc/devel/development_workflow.rst similarity index 73% rename from doc/devel/gitwash/development_workflow.rst rename to doc/devel/development_workflow.rst index d2917230d3ad..33d37f03f851 100644 --- a/doc/devel/gitwash/development_workflow.rst +++ b/doc/devel/development_workflow.rst @@ -6,10 +6,6 @@ Development workflow #################### -You already have your own forked copy of the `Matplotlib`_ repository, by -following :ref:`forking`. You have :ref:`set-up-fork`. You have configured -git by following :ref:`configure-git`. Now you are ready for some real work. - Workflow summary ================ @@ -17,30 +13,26 @@ In what follows we'll refer to the upstream Matplotlib ``main`` branch, as "trunk". * Don't use your ``main`` branch for anything. Consider deleting it. -* When you are starting a new set of changes, fetch any changes from trunk, +* When you are starting a new set of changes, fetch any changes from ``main``, and start a new *feature branch* from that. -* Make a new branch for each separable set of changes |emdash| "one task, one - branch" (`ipython git workflow`_). +* Make a new branch for each separable set of changes — "one task, one + branch". * Name your branch for the purpose of the changes - e.g. ``bugfix-for-issue-14`` or ``refactor-database-code``. -* If you can possibly avoid it, avoid merging trunk or any other branches into - your feature branch while you are working. -* If you do find yourself merging from trunk, consider :ref:`rebase-on-trunk` -* Ask on the `Matplotlib mailing list`_ if you get stuck. +* If you get stuck, reach out on Gitter or the Mailing list. * Ask for code review! This way of working helps to keep work well organized, with readable history. This in turn makes it easier for project maintainers (that might be you) to see what you've done, and why you did it. -See `linux git workflow`_ and `ipython git workflow`_ for some explanation. +.. note:: -Consider deleting your main branch -================================== + It may sound strange, but deleting your own ``main`` branch can help reduce + confusion about which branch you are on. See `deleting main on github`_ for + details. -It may sound strange, but deleting your own ``main`` branch can help reduce -confusion about which branch you are on. See `deleting main on github`_ for -details. +.. _deleting main on github: https://matthew-brett.github.io/pydagogue/gh_delete_master.html .. _update-mirror-trunk: @@ -82,8 +74,8 @@ what the changes in the branch are for. For example ``add-ability-to-fly``, or git branch my-new-feature upstream/main git checkout my-new-feature -Generally, you will want to keep your feature branches on your public github_ -fork of `Matplotlib`_. To do this, you `git push`_ this new branch up to your +Generally, you will want to keep your feature branches on your public GitHub +fork of Matplotlib. To do this, you ``git push`` this new branch up to your github repo. Generally (if you followed the instructions in these pages, and by default), git will have a link to your github repo, called ``origin``. You push up to your own repo on github with:: @@ -117,7 +109,7 @@ In more detail -------------- #. Make some changes -#. See which files have changed with ``git status`` (see `git status`_). +#. See which files have changed with ``git status``. You'll see a listing like this one: .. code-block:: none @@ -135,90 +127,40 @@ In more detail # INSTALL no changes added to commit (use "git add" and/or "git commit -a") -#. Check what the actual changes are with ``git diff`` (`git diff`_). -#. Add any new files to version control ``git add new_file_name`` (see - `git add`_). +#. Check what the actual changes are with ``git diff``. +#. Add any new files to version control ``git add new_file_name``. #. To commit all modified files into the local copy of your repo,, do ``git commit -am 'A commit message'``. Note the ``-am`` options to ``commit``. The ``m`` flag just signals that you're going to type a - message on the command line. The ``a`` flag |emdash| you can just take on - faith |emdash| or see `why the -a flag?`_ |emdash| and the helpful use-case - description in the `tangled working copy problem`_. The `git commit`_ manual - page might also be useful. + message on the command line. The ``a`` flag — you can just take on + faith — or see `why the -a flag?`_ — and the helpful use-case + description in the `tangled working copy problem`_. The + `git commit `_ manual page might also be + useful. #. To push the changes up to your forked repo on github, do a ``git - push`` (see `git push`_). - -Ask for your changes to be reviewed or merged -============================================= - -When you are ready to ask for someone to review your code and consider a merge: + push``. -#. Go to the URL of your forked repo, say - ``https://github.com/your-user-name/matplotlib``. -#. Use the 'Switch Branches' dropdown menu near the top left of the page to - select the branch with your changes: +.. _why the -a flag?: http://gitready.com/beginner/2009/01/18/the-staging-area.html +.. _tangled working copy problem: http://2ndscale.com/rtomayko/2008/the-thing-about-git - .. image:: branch_dropdown.png -#. Click on the 'Pull request' button: +Ask for your changes to be reviewed or merged +============================================= - .. image:: pull_button.png +When you are ready to ask for someone to review your code and consider a merge, +`submit your Pull Request (PR) `_. - Enter a title for the set of changes, and some explanation of what you've - done. Say if there is anything you'd like particular attention for - like a - complicated change or some code you are not happy with. +Enter a title for the set of changes, and some explanation of what you've done. +Say if there is anything you'd like particular attention for - like a +complicated change or some code you are not happy with. - If you don't think your request is ready to be merged, just say so in your - pull request message. This is still a good way of getting some preliminary - code review. +If you don't think your request is ready to be merged, just say so in your pull +request message. This is still a good way of getting some preliminary code +review. Some other things you might want to do ====================================== -Delete a branch on github -------------------------- - -:: - - git checkout main - # delete branch locally - git branch -D my-unwanted-branch - # delete branch on github - git push origin :my-unwanted-branch - -Note the colon ``:`` before ``my-unwanted-branch``. See also: -https://help.github.com/articles/pushing-to-a-remote/#deleting-a-remote-branch-or-tag - -Several people sharing a single repository ------------------------------------------- - -If you want to work on some stuff with other people, where you are all -committing into the same repository, or even the same branch, then just -share it via github. - -First fork Matplotlib into your account, as from :ref:`forking`. - -Then, go to your forked repository github page, say -``https://github.com/your-user-name/matplotlib`` - -Click on the 'Admin' button, and add anyone else to the repo as a -collaborator: - - .. image:: pull_button.png - -Now all those people can do:: - - git clone https://github.com/your-user-name/matplotlib.git - -Remember that links starting with ``https`` or ``git@`` are read-write, and that -``git@`` uses the ssh protocol. - -Your collaborators can then commit directly into that repo with the -usual:: - - git commit -am 'ENH - much better code' - git push origin main # pushes directly into your repo - Explore your repository ----------------------- @@ -231,12 +173,9 @@ To see a linear list of commits for this branch:: git log -You can also look at the `network graph visualizer`_ for your github +You can also look at the `network graph visualizer `_ for your github repo. -Finally the :ref:`fancy-log` ``lg`` alias will give you a reasonable text-based -graph of the repository. - .. _rebase-on-trunk: Rebasing on trunk @@ -275,6 +214,8 @@ your history will look like this: See `rebase without tears`_ for more detail. +.. _rebase without tears: https://matthew-brett.github.io/pydagogue/rebase_without_tears.html + To do a rebase on trunk:: # Update the mirror of trunk @@ -303,6 +244,10 @@ generate merge conflicts that you need to resolve - see the `git rebase`_ man page for some instructions at the end of the "Description" section. There is some related help on merging in the git user manual - see `resolving a merge`_. +.. _git rebase: https://git-scm.com/docs/git-rebase +.. _resolving a merge: https://schacon.github.io/git/user-manual.html#resolving-a-merge + + .. _recovering-from-mess-up: Recovering from mess-ups @@ -419,5 +364,3 @@ and the history looks now like this:: If it went wrong, recovery is again possible as explained :ref:`above `. - -.. include:: links.inc diff --git a/doc/devel/gitwash/branch_dropdown.png b/doc/devel/gitwash/branch_dropdown.png deleted file mode 100644 index 1bb7a577732c91ee6aa31de8f81045b5622126b2..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 16311 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 diff --git a/doc/devel/gitwash/forking_hell.rst b/doc/devel/gitwash/forking_hell.rst deleted file mode 100644 index b79e13400a62..000000000000 --- a/doc/devel/gitwash/forking_hell.rst +++ /dev/null @@ -1,34 +0,0 @@ -.. highlight:: bash - -.. _forking: - -====================================================== -Making your own copy (fork) of Matplotlib -====================================================== - -You need to do this only once. The instructions here are very similar -to the instructions at https://help.github.com/forking/ |emdash| please see -that page for more detail. We're repeating some of it here just to give the -specifics for the `Matplotlib`_ project, and to suggest some default names. - -Set up and configure a github account -===================================== - -If you don't have a github account, go to the github page, and make one. - -You then need to configure your account to allow write access |emdash| see -the ``Generating SSH keys`` help on `github help`_. - -Create your own forked copy of `Matplotlib`_ -====================================================== - -#. Log into your github account. -#. Go to the `Matplotlib`_ github home at `Matplotlib github`_. -#. Click on the *fork* button: - - .. image:: forking_button.png - - Now, after a short pause, you should find yourself at the home page for - your own forked copy of `Matplotlib`_. - -.. include:: links.inc diff --git a/doc/devel/gitwash/git_development.rst b/doc/devel/gitwash/git_development.rst deleted file mode 100644 index c5b910d86342..000000000000 --- a/doc/devel/gitwash/git_development.rst +++ /dev/null @@ -1,16 +0,0 @@ -.. _git-development: - -===================== - Git for development -===================== - -Contents: - -.. toctree:: - :maxdepth: 2 - - forking_hell - set_up_fork - configure_git - development_workflow - maintainer_workflow diff --git a/doc/devel/gitwash/git_install.rst b/doc/devel/gitwash/git_install.rst deleted file mode 100644 index 66eca8c29bde..000000000000 --- a/doc/devel/gitwash/git_install.rst +++ /dev/null @@ -1,28 +0,0 @@ -.. highlight:: bash - -.. _install-git: - -============= - Install git -============= - -Overview -======== - -================ ============= -Debian / Ubuntu ``sudo apt-get install git`` -Fedora ``sudo yum install git`` -Windows Download and install msysGit_ -OS X Use the git-osx-installer_ -================ ============= - -In detail -========= - -See the git page for the most recent information. - -Have a look at the github install help pages available from `github help`_ - -There are good instructions here: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git - -.. include:: links.inc diff --git a/doc/devel/gitwash/git_intro.rst b/doc/devel/gitwash/git_intro.rst deleted file mode 100644 index 1f89b7e9fb51..000000000000 --- a/doc/devel/gitwash/git_intro.rst +++ /dev/null @@ -1,20 +0,0 @@ -.. highlight:: bash - -============== - Introduction -============== - -These pages describe a git_ and github_ workflow for the `Matplotlib`_ -project. - -There are several different workflows here, for different ways of -working with *Matplotlib*. - -This is not a comprehensive git reference, it's just a workflow for our -own project. It's tailored to the github hosting service. You may well -find better or quicker ways of getting stuff done with git, but these -should get you started. - -For general resources for learning git, see :ref:`git-resources`. - -.. include:: links.inc diff --git a/doc/devel/gitwash/git_links.inc b/doc/devel/gitwash/git_links.inc deleted file mode 100644 index 67ddc4dcb5a6..000000000000 --- a/doc/devel/gitwash/git_links.inc +++ /dev/null @@ -1,59 +0,0 @@ -.. This (-*- rst -*-) format file contains commonly used link targets - and name substitutions. It may be included in many files, - therefore it should only contain link targets and name - substitutions. Try grepping for "^\.\. _" to find plausible - candidates for this list. - -.. NOTE: reST targets are - __not_case_sensitive__, so only one target definition is needed for - nipy, NIPY, Nipy, etc... - -.. git stuff -.. _git: https://git-scm.com/ -.. _github: https://github.com -.. _github help: https://help.github.com -.. _msysgit: https://git-scm.com/download/win -.. _git-osx-installer: https://git-scm.com/download/mac -.. _subversion: https://subversion.apache.org/ -.. _git cheat sheet: https://help.github.com/git-cheat-sheets/ -.. _pro git book: https://git-scm.com/book/en/v2 -.. _git svn crash course: https://git-scm.com/course/svn.html -.. _network graph visualizer: https://github.com/blog/39-say-hello-to-the-network-graph-visualizer -.. _git user manual: https://schacon.github.io/git/user-manual.html -.. _git tutorial: https://schacon.github.io/git/gittutorial.html -.. _git community book: https://git-scm.com/book/en/v2 -.. _git ready: http://gitready.com/ -.. _Fernando's git page: http://www.fperez.org/py4science/git.html -.. _git magic: http://www-cs-students.stanford.edu/~blynn/gitmagic/index.html -.. _git concepts: https://www.sbf5.com/~cduan/technical/git/ -.. _git clone: https://schacon.github.io/git/git-clone.html -.. _git checkout: https://schacon.github.io/git/git-checkout.html -.. _git commit: https://schacon.github.io/git/git-commit.html -.. _git push: https://schacon.github.io/git/git-push.html -.. _git pull: https://schacon.github.io/git/git-pull.html -.. _git add: https://schacon.github.io/git/git-add.html -.. _git status: https://schacon.github.io/git/git-status.html -.. _git diff: https://schacon.github.io/git/git-diff.html -.. _git log: https://schacon.github.io/git/git-log.html -.. _git branch: https://schacon.github.io/git/git-branch.html -.. _git remote: https://schacon.github.io/git/git-remote.html -.. _git rebase: https://schacon.github.io/git/git-rebase.html -.. _git config: https://schacon.github.io/git/git-config.html -.. _why the -a flag?: http://gitready.com/beginner/2009/01/18/the-staging-area.html -.. _git staging area: http://gitready.com/beginner/2009/01/18/the-staging-area.html -.. _tangled working copy problem: http://2ndscale.com/rtomayko/2008/the-thing-about-git -.. _git management: https://web.archive.org/web/20090224195437/http://kerneltrap.org/Linux/Git_Management -.. _linux git workflow: https://www.mail-archive.com/dri-devel@lists.sourceforge.net/msg39091.html -.. _git parable: http://tom.preston-werner.com/2009/05/19/the-git-parable.html -.. _git foundation: https://matthew-brett.github.io/pydagogue/foundation.html -.. _deleting main on github: https://matthew-brett.github.io/pydagogue/gh_delete_master.html -.. _rebase without tears: https://matthew-brett.github.io/pydagogue/rebase_without_tears.html -.. _resolving a merge: https://schacon.github.io/git/user-manual.html#resolving-a-merge -.. _ipython git workflow: https://mail.python.org/pipermail/ipython-dev/2010-October/005632.html - -.. other stuff -.. _python: https://www.python.org - -.. |emdash| unicode:: U+02014 - -.. vim: ft=rst diff --git a/doc/devel/gitwash/git_resources.rst b/doc/devel/gitwash/git_resources.rst deleted file mode 100644 index 2787a575cc43..000000000000 --- a/doc/devel/gitwash/git_resources.rst +++ /dev/null @@ -1,59 +0,0 @@ -.. highlight:: bash - -.. _git-resources: - -============= -git resources -============= - -Tutorials and summaries -======================= - -* `github help`_ has an excellent series of how-to guides. -* The `pro git book`_ is a good in-depth book on git. -* A `git cheat sheet`_ is a page giving summaries of common commands. -* The `git user manual`_ -* The `git tutorial`_ -* The `git community book`_ -* `git ready`_ |emdash| a nice series of tutorials -* `git magic`_ |emdash| extended introduction with intermediate detail -* The `git parable`_ is an easy read explaining the concepts behind git. -* `git foundation`_ expands on the `git parable`_. -* Fernando Perez' git page |emdash| `Fernando's git page`_ |emdash| many - links and tips -* A good but technical page on `git concepts`_ -* `git svn crash course`_: git for those of us used to subversion_ - -Advanced git workflow -===================== - -There are many ways of working with git; here are some posts on the -rules of thumb that other projects have come up with: - -* Linus Torvalds on `git management`_ -* Linus Torvalds on `linux git workflow`_ . Summary; use the git tools - to make the history of your edits as clean as possible; merge from - upstream edits as little as possible in branches where you are doing - active development. - -Manual pages online -=================== - -You can get these on your own machine with (e.g) ``git help push`` or -(same thing) ``git push --help``, but, for convenience, here are the -online manual pages for some common commands: - -* `git add`_ -* `git branch`_ -* `git checkout`_ -* `git clone`_ -* `git commit`_ -* `git config`_ -* `git diff`_ -* `git log`_ -* `git pull`_ -* `git push`_ -* `git remote`_ -* `git status`_ - -.. include:: links.inc diff --git a/doc/devel/gitwash/index.rst b/doc/devel/gitwash/index.rst deleted file mode 100644 index 9ee965d626ff..000000000000 --- a/doc/devel/gitwash/index.rst +++ /dev/null @@ -1,19 +0,0 @@ -.. _using-git: - -Working with *Matplotlib* source code -================================================ - -Contents: - -.. toctree:: - :maxdepth: 2 - - git_intro - git_install - following_latest - patching - git_development - git_resources - dot2_dot3 - - diff --git a/doc/devel/gitwash/known_projects.inc b/doc/devel/gitwash/known_projects.inc deleted file mode 100644 index 710abe08e477..000000000000 --- a/doc/devel/gitwash/known_projects.inc +++ /dev/null @@ -1,41 +0,0 @@ -.. Known projects - -.. PROJECTNAME placeholders -.. _PROJECTNAME: http://nipy.org -.. _`PROJECTNAME github`: https://github.com/nipy -.. _`PROJECTNAME mailing list`: https://mail.python.org/mailman/listinfo/neuroimaging - -.. numpy -.. _numpy: http://www.numpy.org -.. _`numpy github`: https://github.com/numpy/numpy -.. _`numpy mailing list`: https://mail.scipy.org/mailman/listinfo/numpy-discussion - -.. scipy -.. _scipy: https://www.scipy.org -.. _`scipy github`: https://github.com/scipy/scipy -.. _`scipy mailing list`: https://mail.scipy.org/mailman/listinfo/scipy-dev - -.. nipy -.. _nipy: http://nipy.org/nipy/ -.. _`nipy github`: https://github.com/nipy/nipy -.. _`nipy mailing list`: https://mail.python.org/mailman/listinfo/neuroimaging - -.. ipython -.. _ipython: https://ipython.org -.. _`ipython github`: https://github.com/ipython/ipython -.. _`ipython mailing list`: https://mail.scipy.org/mailman/listinfo/IPython-dev - -.. dipy -.. _dipy: http://nipy.org/dipy/ -.. _`dipy github`: https://github.com/Garyfallidis/dipy -.. _`dipy mailing list`: https://mail.python.org/mailman/listinfo/neuroimaging - -.. nibabel -.. _nibabel: http://nipy.org/nibabel/ -.. _`nibabel github`: https://github.com/nipy/nibabel -.. _`nibabel mailing list`: https://mail.python.org/mailman/listinfo/neuroimaging - -.. marsbar -.. _marsbar: http://marsbar.sourceforge.net -.. _`marsbar github`: https://github.com/matthew-brett/marsbar -.. _`MarsBaR mailing list`: https://lists.sourceforge.net/lists/listinfo/marsbar-users diff --git a/doc/devel/gitwash/links.inc b/doc/devel/gitwash/links.inc deleted file mode 100644 index 20f4dcfffd4a..000000000000 --- a/doc/devel/gitwash/links.inc +++ /dev/null @@ -1,4 +0,0 @@ -.. compiling links file -.. include:: known_projects.inc -.. include:: this_project.inc -.. include:: git_links.inc diff --git a/doc/devel/gitwash/patching.rst b/doc/devel/gitwash/patching.rst deleted file mode 100644 index aeea8c5394ac..000000000000 --- a/doc/devel/gitwash/patching.rst +++ /dev/null @@ -1,138 +0,0 @@ -.. highlight:: bash - -================ - Making a patch -================ - -You've discovered a bug or something else you want to change -in `Matplotlib`_ .. |emdash| excellent! - -You've worked out a way to fix it |emdash| even better! - -You want to tell us about it |emdash| best of all! - -The easiest way is to make a *patch* or set of patches. Here -we explain how. Making a patch is the simplest and quickest, -but if you're going to be doing anything more than simple -quick things, please consider following the -:ref:`git-development` model instead. - -.. _making-patches: - -Making patches -============== - -Overview --------- - -:: - - # tell git who you are - git config --global user.email you@yourdomain.example.com - git config --global user.name "Your Name Comes Here" - # get the repository if you don't have it - git clone https://github.com/matplotlib/matplotlib.git - # make a branch for your patching - cd matplotlib - git branch the-fix-im-thinking-of - git checkout the-fix-im-thinking-of - # hack, hack, hack - # Tell git about any new files you've made - git add somewhere/tests/test_my_bug.py - # commit work in progress as you go - git commit -am 'BF - added tests for Funny bug' - # hack hack, hack - git commit -am 'BF - added fix for Funny bug' - # make the patch files - git format-patch -M -C main - -Then, send the generated patch files to the `Matplotlib -mailing list`_ |emdash| where we will thank you warmly. - -In detail ---------- - -#. Tell git who you are so it can label the commits you've - made:: - - git config --global user.email you@yourdomain.example.com - git config --global user.name "Your Name Comes Here" - -#. If you don't already have one, clone a copy of the - `Matplotlib`_ repository:: - - git clone https://github.com/matplotlib/matplotlib.git - cd matplotlib - -#. Make a 'feature branch'. This will be where you work on - your bug fix. It's nice and safe and leaves you with - access to an unmodified copy of the code in the main - branch:: - - git branch the-fix-im-thinking-of - git checkout the-fix-im-thinking-of - -#. Do some edits, and commit them as you go:: - - # hack, hack, hack - # Tell git about any new files you've made - git add somewhere/tests/test_my_bug.py - # commit work in progress as you go - git commit -am 'BF - added tests for Funny bug' - # hack hack, hack - git commit -am 'BF - added fix for Funny bug' - - Note the ``-am`` options to ``commit``. The ``m`` flag just - signals that you're going to type a message on the command - line. The ``a`` flag |emdash| you can just take on faith |emdash| - or see `why the -a flag?`_. - -#. When you have finished, check you have committed all your - changes:: - - git status - -#. Finally, make your commits into patches. You want all the - commits since you branched from the ``main`` branch:: - - git format-patch -M -C main - - You will now have several files named for the commits: - - .. code-block:: none - - 0001-BF-added-tests-for-Funny-bug.patch - 0002-BF-added-fix-for-Funny-bug.patch - - Send these files to the `Matplotlib mailing list`_. - -When you are done, to switch back to the main copy of the -code, just return to the ``main`` branch:: - - git checkout main - -Moving from patching to development -=================================== - -If you find you have done some patches, and you have one or -more feature branches, you will probably want to switch to -development mode. You can do this with the repository you -have. - -Fork the `Matplotlib`_ repository on github |emdash| :ref:`forking`. -Then:: - - # checkout and refresh main branch from main repo - git checkout main - git pull origin main - # rename pointer to main repository to 'upstream' - git remote rename origin upstream - # point your repo to default read / write to your fork on github - git remote add origin git@github.com:your-user-name/matplotlib.git - # push up any branches you've made and want to keep - git push origin the-fix-im-thinking-of - -Then you can, if you want, follow the -:ref:`development-workflow`. - -.. include:: links.inc diff --git a/doc/devel/gitwash/pull_button.png b/doc/devel/gitwash/pull_button.png deleted file mode 100644 index e5031681b97bcc3b323a01653153c8d6bcfb5507..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 12893 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 I#f$>~7cL{PD*ylh diff --git a/doc/devel/gitwash/set_up_fork.rst b/doc/devel/gitwash/set_up_fork.rst deleted file mode 100644 index cfbd00dca63f..000000000000 --- a/doc/devel/gitwash/set_up_fork.rst +++ /dev/null @@ -1,68 +0,0 @@ -.. highlight:: bash - -.. _set-up-fork: - -================== - Set up your fork -================== - -First you follow the instructions for :ref:`forking`. - -Overview -======== - -:: - - git clone https://github.com/your-user-name/matplotlib.git - cd matplotlib - git remote add upstream https://github.com/matplotlib/matplotlib.git - -In detail -========= - -Clone your fork ---------------- - -#. Clone your fork to the local computer with ``git clone - https://github.com/your-user-name/matplotlib.git`` -#. Investigate. Change directory to your new repo: ``cd matplotlib``. Then - ``git branch -a`` to show you all branches. You'll get something - like: - - .. code-block:: none - - * main - remotes/origin/main - - This tells you that you are currently on the ``main`` branch, and - that you also have a ``remote`` connection to ``origin/main``. - What remote repository is ``remote/origin``? Try ``git remote -v`` to - see the URLs for the remote. They will point to your github fork. - - Now you want to connect to the upstream `Matplotlib github`_ repository, so - you can merge in changes from trunk. - -.. _linking-to-upstream: - -Linking your repository to the upstream repo --------------------------------------------- - -:: - - cd matplotlib - git remote add upstream https://github.com/matplotlib/matplotlib.git - -``upstream`` here is just the arbitrary name we're using to refer to the -main `Matplotlib`_ repository at `Matplotlib github`_. - -Just for your own satisfaction, show yourself that you now have a new -'remote', with ``git remote -v show``, giving you something like: - -.. code-block:: none - - upstream https://github.com/matplotlib/matplotlib.git (fetch) - upstream https://github.com/matplotlib/matplotlib.git (push) - origin https://github.com/your-user-name/matplotlib.git (fetch) - origin https://github.com/your-user-name/matplotlib.git (push) - -.. include:: links.inc diff --git a/doc/devel/gitwash/this_project.inc b/doc/devel/gitwash/this_project.inc deleted file mode 100644 index e8863d5f78f0..000000000000 --- a/doc/devel/gitwash/this_project.inc +++ /dev/null @@ -1,5 +0,0 @@ -.. Matplotlib -.. _`Matplotlib`: http://matplotlib.org -.. _`Matplotlib github`: https://github.com/matplotlib/matplotlib - -.. _`Matplotlib mailing list`: https://mail.python.org/mailman/listinfo/matplotlib-devel diff --git a/doc/devel/index.rst b/doc/devel/index.rst index 462205ee2271..66787b62736e 100644 --- a/doc/devel/index.rst +++ b/doc/devel/index.rst @@ -57,14 +57,15 @@ process or how to fix something feel free to ask on `gitter contributing.rst triage.rst development_setup.rst + development_workflow.rst testing.rst documenting_mpl.rst style_guide.rst - gitwash/index.rst coding_guide.rst release_guide.rst dependencies.rst min_dep_policy.rst + maintainer_workflow.rst MEP/index .. toctree:: diff --git a/doc/devel/gitwash/maintainer_workflow.rst b/doc/devel/maintainer_workflow.rst similarity index 96% rename from doc/devel/gitwash/maintainer_workflow.rst rename to doc/devel/maintainer_workflow.rst index 9a572e311168..f11375e26d1b 100644 --- a/doc/devel/gitwash/maintainer_workflow.rst +++ b/doc/devel/maintainer_workflow.rst @@ -6,7 +6,7 @@ Maintainer workflow ################### -This page is for maintainers |emdash| those of us who merge our own or other +This page is for maintainers — those of us who merge our own or other peoples' changes into the upstream repository. Being as how you're a maintainer, you are completely on top of the basic stuff @@ -94,5 +94,3 @@ Push to trunk This pushes the ``my-new-feature`` branch in this repository to the ``main`` branch in the ``upstream-rw`` repository. - -.. include:: links.inc From 7c1e0378de362d6f24466941f98507134728e6cb Mon Sep 17 00:00:00 2001 From: melissawm Date: Sun, 28 Aug 2022 14:56:39 -0300 Subject: [PATCH 2/5] Addressing review comments --- doc/devel/coding_guide.rst | 19 +++++++++++-------- doc/devel/development_workflow.rst | 12 +++++------- 2 files changed, 16 insertions(+), 15 deletions(-) diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst index f26d1d09db8a..5ba185c40c8f 100644 --- a/doc/devel/coding_guide.rst +++ b/doc/devel/coding_guide.rst @@ -13,19 +13,19 @@ Pull request guidelines *********************** -Pull requests (PRs) are the mechanism for contributing to Matplotlib's code and -documentation. +`Pull requests (PRs) on GitHub `__ +are the mechanism for contributing to Matplotlib's code and documentation. It is recommended to check that your contribution complies with the following rules before submitting a pull request: * If your pull request addresses an issue, please use the title to describe the - issue and mention the issue number in the pull request description to ensure - that a link is created to the original issue. - -* All public methods should have informative docstrings with sample usage when - appropriate. Use the `numpy docstring standard - `_. + issue (e.g. "Add ability to plot timedeltas") and mention the issue number + in the pull request description to ensure that a link is created to the + original issue (e.g. "Closes #8869" or "Fixes #8869"). This will ensure the + original issue mentioned is automatically closed when your PR is merged. See + `the GitHub documentation `__ + for more details. * Formatting should follow the recommendations of PEP8_, as enforced by flake8_. You can check flake8 compliance from the command line with :: @@ -45,6 +45,9 @@ rules before submitting a pull request: .. __: https://github.com/psf/black/issues/148 .. __: https://github.com/psf/black/issues/1984 +* All public methods should have informative docstrings with sample usage when + appropriate. Use the :ref:`docstring standards `. + * Each high-level plotting function should have a simple example in the ``Example`` section of the docstring. This should be as simple as possible to demonstrate the method. More complex examples should go in the diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst index 33d37f03f851..70dd2b1d5055 100644 --- a/doc/devel/development_workflow.rst +++ b/doc/devel/development_workflow.rst @@ -19,8 +19,9 @@ In what follows we'll refer to the upstream Matplotlib ``main`` branch, as branch". * Name your branch for the purpose of the changes - e.g. ``bugfix-for-issue-14`` or ``refactor-database-code``. -* If you get stuck, reach out on Gitter or the Mailing list. -* Ask for code review! +* If you get stuck, reach out on Gitter or + `discourse `__. +* Ask for a code review! This way of working helps to keep work well organized, with readable history. This in turn makes it easier for project maintainers (that might be you) to see @@ -155,8 +156,8 @@ Say if there is anything you'd like particular attention for - like a complicated change or some code you are not happy with. If you don't think your request is ready to be merged, just say so in your pull -request message. This is still a good way of getting some preliminary code -review. +request message and use the "Draft PR" feature of GitHub. This is a good way of +getting some preliminary code review. Some other things you might want to do ====================================== @@ -173,9 +174,6 @@ To see a linear list of commits for this branch:: git log -You can also look at the `network graph visualizer `_ for your github -repo. - .. _rebase-on-trunk: Rebasing on trunk From e592e7acd8fb640b5f9df1d6b97fdfc0c98d74d0 Mon Sep 17 00:00:00 2001 From: melissawm Date: Mon, 29 Aug 2022 14:13:54 -0300 Subject: [PATCH 3/5] Addressing more review suggestions --- doc/devel/coding_guide.rst | 7 +-- doc/devel/development_setup.rst | 42 ++++++-------- doc/devel/development_workflow.rst | 92 ++++++++++++++---------------- 3 files changed, 66 insertions(+), 75 deletions(-) diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst index 5ba185c40c8f..1e50f0e9a0d5 100644 --- a/doc/devel/coding_guide.rst +++ b/doc/devel/coding_guide.rst @@ -48,10 +48,9 @@ rules before submitting a pull request: * All public methods should have informative docstrings with sample usage when appropriate. Use the :ref:`docstring standards `. -* Each high-level plotting function should have a simple example in the - ``Example`` section of the docstring. This should be as simple as possible - to demonstrate the method. More complex examples should go in the - ``examples`` tree. +* For high-level plotting functions, consider adding a simple example either in + the ``Example`` section of the docstring or the + :ref:`examples gallery `. * Changes (both new features and bugfixes) should have good test coverage. See :ref:`testing` for more details. diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst index 1e3017060d6a..4eadaeb20389 100644 --- a/doc/devel/development_setup.rst +++ b/doc/devel/development_setup.rst @@ -37,10 +37,24 @@ You can retrieve the latest sources with the command (see .. _SSH key: https://docs.github.com/en/authentication/connecting-to-github-with-ssh This will place the sources in a directory :file:`matplotlib` below your -current working directory. Change into this directory:: +current working directory, and set up the `upstream remote `__ +to point to the Matplotlib main repository. Change into this directory before +continuing:: cd matplotlib +.. note:: + + For more information on ``git`` and ``GitHub``, check the following resources. + + * `Git documentation `_ + * `Git-Contributing to a Project `_ + * `Introduction to GitHub `_ + * :ref:`using-git` + * :ref:`git-resources` + * `Installing git `_ + * https://tacaswell.github.io/think-like-git.html + * https://tom.preston-werner.com/2009/05/19/the-git-parable.html .. _dev-environment: @@ -91,30 +105,8 @@ After you have cloned the repo change into the matplotlib directory. Remember to activate the environment whenever you start working on Matplotlib. -<<<<<<< HEAD -Install additional development dependencies -=========================================== -See :ref:`development-dependencies`. - -======= -<<<<<<< HEAD ->>>>>>> e998d58f3c (Refactoring gitwash) -Install Matplotlib in editable mode -=================================== -======= -.. seealso:: - - * `Git documentation `_ - * `Git-Contributing to a Project `_ - * `Introduction to GitHub `_ - * :ref:`using-git` - * :ref:`git-resources` - * `Installing git `_ - - Installing Matplotlib in editable mode ====================================== ->>>>>>> 0e759d3ee8 (Refactoring gitwash) Install Matplotlib in editable mode from the :file:`matplotlib` directory using the command :: @@ -128,6 +120,10 @@ true for ``*.py`` files. If you change the C-extension source (which might also happen if you change branches) you will have to re-run ``python -m pip install -ve .`` +Install additional development dependencies +=========================================== +See :ref:`development-dependencies`. + Install pre-commit hooks (optional) =================================== `pre-commit `_ hooks automatically check flake8 and diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst index 70dd2b1d5055..01b13d275dd6 100644 --- a/doc/devel/development_workflow.rst +++ b/doc/devel/development_workflow.rst @@ -9,23 +9,21 @@ Development workflow Workflow summary ================ -In what follows we'll refer to the upstream Matplotlib ``main`` branch, as -"trunk". +To keep your work well organized, with readable history, and in turn make it +easier for project maintainers (that might be you) to see what you've done, and +why you did it, we recommend the following: * Don't use your ``main`` branch for anything. Consider deleting it. -* When you are starting a new set of changes, fetch any changes from ``main``, - and start a new *feature branch* from that. -* Make a new branch for each separable set of changes — "one task, one - branch". +* Before starting a new set of changes, fetch all changes from + ``upstream/main``, and start a new *feature branch* from that. +* Make a new branch for each feature or bug fix — "one task, one branch". * Name your branch for the purpose of the changes - e.g. ``bugfix-for-issue-14`` or ``refactor-database-code``. * If you get stuck, reach out on Gitter or `discourse `__. -* Ask for a code review! - -This way of working helps to keep work well organized, with readable history. -This in turn makes it easier for project maintainers (that might be you) to see -what you've done, and why you did it. +* When your ready or need feedback on your code, open a pull-request so that the + Matplotlib developers can give feedback and eventually include your suggested + code into the ``main`` branch. .. note:: @@ -35,21 +33,19 @@ what you've done, and why you did it. .. _deleting main on github: https://matthew-brett.github.io/pydagogue/gh_delete_master.html -.. _update-mirror-trunk: +.. _update-mirror-main: -Update the mirror of trunk -========================== +Update the mirror of main +========================= First make sure you have done :ref:`linking-to-upstream`. -From time to time you should fetch the upstream (trunk) changes from github:: +From time to time you should fetch the upstream changes from github:: git fetch upstream This will pull down any commits you don't have, and set the remote branches to -point to the right commit. For example, 'trunk' is the branch referred to by -(remote/branchname) ``upstream/main`` - and if there have been commits since -you last checked, ``upstream/main`` will change after you do the fetch. +point to the right commit. .. _make-feature-branch: @@ -69,17 +65,17 @@ what the changes in the branch are for. For example ``add-ability-to-fly``, or :: - # Update the mirror of trunk + # Update the mirror of main git fetch upstream - # Make new feature branch starting at current trunk + # Make new feature branch starting at current main git branch my-new-feature upstream/main git checkout my-new-feature Generally, you will want to keep your feature branches on your public GitHub fork of Matplotlib. To do this, you ``git push`` this new branch up to your -github repo. Generally (if you followed the instructions in these pages, and by -default), git will have a link to your github repo, called ``origin``. You push -up to your own repo on github with:: +GitHub repo. Generally (if you followed the instructions in these pages, and by +default), git will have a link to your fork of the GitHub repo, called +``origin``. You push up to your own fork with:: git push origin my-new-feature @@ -89,7 +85,7 @@ In git >= 1.7 you can ensure that the link is correctly set by using the git push --set-upstream origin my-new-feature From now on git will know that ``my-new-feature`` is related to the -``my-new-feature`` branch in the github repo. +``my-new-feature`` branch in the GitHub repo. .. _edit-flow: @@ -145,8 +141,8 @@ In more detail .. _tangled working copy problem: http://2ndscale.com/rtomayko/2008/the-thing-about-git -Ask for your changes to be reviewed or merged -============================================= +Open a pull request +=================== When you are ready to ask for someone to review your code and consider a merge, `submit your Pull Request (PR) `_. @@ -174,55 +170,55 @@ To see a linear list of commits for this branch:: git log -.. _rebase-on-trunk: +.. _rebase-on-main: -Rebasing on trunk ------------------ +Rebasing on ``upstream/main`` +----------------------------- Let's say you thought of some work you'd like to do. You -:ref:`update-mirror-trunk` and :ref:`make-feature-branch` called -``cool-feature``. At this stage trunk is at some commit, let's call it E. Now -you make some new commits on your ``cool-feature`` branch, let's call them A, B, -C. Maybe your changes take a while, or you come back to them after a while. In -the meantime, trunk has progressed from commit E to commit (say) G: +:ref:`update-mirror-main` and :ref:`make-feature-branch` called +``cool-feature``. At this stage, ``main`` is at some commit, let's call it E. +Now you make some new commits on your ``cool-feature`` branch, let's call them +A, B, C. Maybe your changes take a while, or you come back to them after a +while. In the meantime, ``main`` has progressed from commit E to commit (say) G: .. code-block:: none A---B---C cool-feature / - D---E---F---G trunk + D---E---F---G main -At this stage you consider merging trunk into your feature branch, and you +At this stage you consider merging ``main`` into your feature branch, and you remember that this here page sternly advises you not to do that, because the history will get messy. Most of the time you can just ask for a review, and not -worry that trunk has got a little ahead. But sometimes, the changes in trunk -might affect your changes, and you need to harmonize them. In this situation -you may prefer to do a rebase. +worry that ``main`` has got a little ahead. But sometimes, the changes in +``main`` might affect your changes, and you need to harmonize them. In this +situation you may prefer to do a rebase. -rebase takes your changes (A, B, C) and replays them as if they had been made to -the current state of ``trunk``. In other words, in this case, it takes the -changes represented by A, B, C and replays them on top of G. After the rebase, -your history will look like this: +``rebase`` takes your changes (A, B, C) and replays them as if they had been +made to the current state of ``main``. In other words, in this case, it takes +the changes represented by A, B, C and replays them on top of G. After the +rebase, your history will look like this: .. code-block:: none A'--B'--C' cool-feature / - D---E---F---G trunk + D---E---F---G main See `rebase without tears`_ for more detail. .. _rebase without tears: https://matthew-brett.github.io/pydagogue/rebase_without_tears.html -To do a rebase on trunk:: +To do a rebase on ``upstream/main``:: - # Update the mirror of trunk + # Fetch changes from upstream/main git fetch upstream # go to the feature branch git checkout cool-feature # make a backup in case you mess up git branch tmp cool-feature - # rebase cool-feature onto trunk + # rebase cool-feature onto main git rebase --onto upstream/main upstream/main cool-feature In this situation, where you are already on branch ``cool-feature``, the last @@ -237,7 +233,7 @@ When all looks good you can delete your backup branch:: If it doesn't look good you may need to have a look at :ref:`recovering-from-mess-up`. -If you have made changes to files that have also changed in trunk, this may +If you have made changes to files that have also changed in ``main``, this may generate merge conflicts that you need to resolve - see the `git rebase`_ man page for some instructions at the end of the "Description" section. There is some related help on merging in the git user manual - see `resolving a merge`_. From 270fdde701aab5af29a2867d6669cc17e22c9102 Mon Sep 17 00:00:00 2001 From: melissawm Date: Thu, 1 Dec 2022 14:51:16 -0300 Subject: [PATCH 4/5] Reorganizing content --- doc/devel/development_setup.rst | 38 +++++++++++++++++------------- doc/devel/development_workflow.rst | 10 ++++---- 2 files changed, 27 insertions(+), 21 deletions(-) diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst index 4eadaeb20389..7dbb7af9a46d 100644 --- a/doc/devel/development_setup.rst +++ b/doc/devel/development_setup.rst @@ -9,13 +9,22 @@ To set up Matplotlib for development follow these steps: .. contents:: :local: +Fork the Matplotlib repository +============================== + +Matplotlib is hosted at https://github.com/matplotlib/matplotlib.git. If you +plan on solving issues or submit pull requests to the main Matplotlib +repository, you should first *fork* this repository by visiting +https://github.com/matplotlib/matplotlib.git and clicking on the +``Fork`` button on the top right of the page (see +`the GitHub documentation `__ for more details.) + Retrieve the latest version of the code ======================================= -Matplotlib is hosted at https://github.com/matplotlib/matplotlib.git. - -You can retrieve the latest sources with the command (see -`the GitHub documentation `__ for more details):: +Now that your fork of the repository lives under your GitHub username, you can +retrieve the latest sources with one of the following commands (where your +should replace ```` with your GitHub username): .. tab-set:: @@ -23,33 +32,35 @@ You can retrieve the latest sources with the command (see .. code-block:: bash - git clone https://github.com/matplotlib/matplotlib.git + git clone https://github.com//matplotlib.git .. tab-item:: ssh .. code-block:: bash - git clone git@github.com:matplotlib/matplotlib.git + git clone git@github.com:/matplotlib.git This requires you to setup an `SSH key`_ in advance, but saves you from typing your password at every connection. .. _SSH key: https://docs.github.com/en/authentication/connecting-to-github-with-ssh + This will place the sources in a directory :file:`matplotlib` below your -current working directory, and set up the `upstream remote `__ -to point to the Matplotlib main repository. Change into this directory before -continuing:: +current working directory, set up the ``origin`` remote to point to your own +fork, and set up the ``upstream`` remote to point to the Matplotlib main +repository (see also `Managing remote repositories `__.) +Change into this directory before continuing:: cd matplotlib .. note:: - For more information on ``git`` and ``GitHub``, check the following resources. + For more information on ``git`` and ``GitHub``, check the following resources. * `Git documentation `_ * `Git-Contributing to a Project `_ - * `Introduction to GitHub `_ + * `Introduction to GitHub `_ * :ref:`using-git` * :ref:`git-resources` * `Installing git `_ @@ -83,11 +94,6 @@ The simplest way to do this is to use either Python's virtual environment \Scripts\activate.bat # Windows cmd.exe \Scripts\Activate.ps1 # Windows PowerShell -Conda dev environment ---------------------- - -After you have cloned the repo change into the matplotlib directory. - .. tab-item:: conda environment Create a new `conda`_ environment with :: diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst index 01b13d275dd6..724f406961de 100644 --- a/doc/devel/development_workflow.rst +++ b/doc/devel/development_workflow.rst @@ -21,7 +21,7 @@ why you did it, we recommend the following: ``bugfix-for-issue-14`` or ``refactor-database-code``. * If you get stuck, reach out on Gitter or `discourse `__. -* When your ready or need feedback on your code, open a pull-request so that the +* When your ready or need feedback on your code, open a pull request so that the Matplotlib developers can give feedback and eventually include your suggested code into the ``main`` branch. @@ -35,10 +35,10 @@ why you did it, we recommend the following: .. _update-mirror-main: -Update the mirror of main -========================= +Update the ``main`` branch +========================== -First make sure you have done :ref:`linking-to-upstream`. +First make sure you have followed :ref:`installing_for_devs`. From time to time you should fetch the upstream changes from github:: @@ -65,7 +65,7 @@ what the changes in the branch are for. For example ``add-ability-to-fly``, or :: - # Update the mirror of main + # Update the main branch git fetch upstream # Make new feature branch starting at current main git branch my-new-feature upstream/main From 1b7510d52959a07e8f5bf4a98bf87b6005c4f97d Mon Sep 17 00:00:00 2001 From: melissawm Date: Thu, 1 Dec 2022 14:56:53 -0300 Subject: [PATCH 5/5] Addressing more review comments --- doc/devel/coding_guide.rst | 8 +++++--- doc/devel/development_setup.rst | 2 +- doc/devel/development_workflow.rst | 4 ++-- 3 files changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/devel/coding_guide.rst b/doc/devel/coding_guide.rst index 1e50f0e9a0d5..3e9788ade101 100644 --- a/doc/devel/coding_guide.rst +++ b/doc/devel/coding_guide.rst @@ -13,7 +13,8 @@ Pull request guidelines *********************** -`Pull requests (PRs) on GitHub `__ +`Pull requests (PRs) on GitHub +`__ are the mechanism for contributing to Matplotlib's code and documentation. It is recommended to check that your contribution complies with the following @@ -24,7 +25,8 @@ rules before submitting a pull request: in the pull request description to ensure that a link is created to the original issue (e.g. "Closes #8869" or "Fixes #8869"). This will ensure the original issue mentioned is automatically closed when your PR is merged. See - `the GitHub documentation `__ + `the GitHub documentation + `__ for more details. * Formatting should follow the recommendations of PEP8_, as enforced by @@ -85,7 +87,7 @@ rules before submitting a pull request: .. note:: The current state of the Matplotlib code base is not compliant with all - of those guidelines, but we expect that enforcing those constraints on all + of these guidelines, but we expect that enforcing these constraints on all new contributions will move the overall code base quality in the right direction. diff --git a/doc/devel/development_setup.rst b/doc/devel/development_setup.rst index 7dbb7af9a46d..f699b8579ea7 100644 --- a/doc/devel/development_setup.rst +++ b/doc/devel/development_setup.rst @@ -59,7 +59,7 @@ Change into this directory before continuing:: For more information on ``git`` and ``GitHub``, check the following resources. * `Git documentation `_ - * `Git-Contributing to a Project `_ + * `GitHub-Contributing to a Project `_ * `Introduction to GitHub `_ * :ref:`using-git` * :ref:`git-resources` diff --git a/doc/devel/development_workflow.rst b/doc/devel/development_workflow.rst index 724f406961de..cf74012d81b6 100644 --- a/doc/devel/development_workflow.rst +++ b/doc/devel/development_workflow.rst @@ -21,7 +21,7 @@ why you did it, we recommend the following: ``bugfix-for-issue-14`` or ``refactor-database-code``. * If you get stuck, reach out on Gitter or `discourse `__. -* When your ready or need feedback on your code, open a pull request so that the +* When you're ready or need feedback on your code, open a pull request so that the Matplotlib developers can give feedback and eventually include your suggested code into the ``main`` branch. @@ -40,7 +40,7 @@ Update the ``main`` branch First make sure you have followed :ref:`installing_for_devs`. -From time to time you should fetch the upstream changes from github:: +From time to time you should fetch the upstream changes from GitHub:: git fetch upstream