[Configuration] Clean up .gitignore references to personal tools

Developers run all sorts of different tools within Git repositories,
any of which can leave their own special trashfiles all over the
place. We can't every hope to catalog them all, so better to
recommend developers simply configure a global core.excludesfile to
filter the irrelevant files which tend to get created by their
personal choice of tools.

To this end, remove the long-standing sections for "Mr Developer"
and "Editors" since their mere existence here sends the signal that
we welcome (and have time to review) additions for any old tool
someone ever might happen to try. Also add a comment block
explaining this, for clarity.

We can, and should of course, continue to list files created by the
tools recommended by our workflow (test frameworks called from tox,
documentation and packaging builds, et cetera).

Change-Id: I4774772ec30611b0acd1ad2aadcf6a1a3f93938c
This commit is contained in:
Natal Ngétal 2019-01-21 14:52:50 +01:00
parent 1a52affd1a
commit 0239f163b1
2 changed files with 77 additions and 29 deletions

90
.gitignore vendored
View File

@ -1,35 +1,67 @@
AUTHORS # Add patterns in here to exclude files created by tools integrated with this
build/* # repository, such as test frameworks from the project's recommended workflow,
build-stamp # rendered documentation and package builds.
ChangeLog #
# Don't add patterns to exclude files created by preferred personal tools
# (editors, IDEs, your operating system itself even). These should instead be
# maintained outside the repository, for example in a ~/.gitignore file added
# with:
#
# git config --global core.excludesfile '~/.gitignore'
# Bytecompiled Python
*.py[cod]
# C extensions
*.so
# Packages
*.egg*
*.egg-info
dist
build
eggs
parts
bin
var
sdist
develop-eggs
.installed.cfg
lib
lib64
# Installer logs
pip-log.txt
# Unit test / coverage reports
cover/ cover/
covhtml/ .coverage*
dist/ !.coveragerc
doc/build .tox
doc/source/_static/config-samples/*.sample nosetests.xml
doc/source/_static/*.policy.yaml.sample .testrepository
.stestr
.venv
# Translations
*.mo
etc/*.sample etc/*.sample
etc/neutron/plugins/ml2/*.sample etc/neutron/plugins/ml2/*.sample
*.DS_Store
*.pyc # Complexity
neutron.egg-info/ output/*.html
neutron/vcsversion.py output/*/index.html
neutron/versioninfo
pbr*.egg/ # Sphinx
setuptools*.egg/ doc/build
*.log doc/source/_static/nova.conf.sample
*.mo doc/source/_static/nova.policy.yaml.sample
*.sw? doc/source/_static/placement.policy.yaml.sample
*~
/.* # pbr generates these
!/.coveragerc AUTHORS
!/.gitignore ChangeLog
!/.gitreview
!/.mailmap
!/.pylintrc
!/.stestr.conf
!/.zuul.yaml
.stestr/
# Files created by releasenotes build # Files created by releasenotes build
releasenotes/build releasenotes/build

View File

@ -55,6 +55,22 @@ Grab the code::
git clone git://git.openstack.org/openstack/neutron.git git clone git://git.openstack.org/openstack/neutron.git
cd neutron cd neutron
About ignore files
------------------
In the .gitignore files, add patterns to exclude files created by tools
integrated, such as test frameworks from the project's recommended workflow,
rendered documentation and package builds.
Don't add patterns to exculde files created by preferred personal like for
example editors, IDEs or operating system.
These should instead be maintained outside the repository, for example in a
~/.gitignore file added with::
git config --global core.excludesfile '~/.gitignore'
Ignores files for all repositories that you work with.
Testing Neutron Testing Neutron
--------------- ---------------