spack/lib/spack/docs
Michael Kuhn d73fe19d93
Recommend Git's manyFiles feature (#25977)
Git 2.24 introduced a feature flag for repositories with many files, see:
https://github.blog/2019-11-03-highlights-from-git-2-24/#feature-macros

Since Spack's Git repository contains roughly 8,500 files, it can be
worthwhile to enable this, especially on slow file systems such as NFS:
```
$ hyperfine --warmup 3 'cd spack-default; git status' 'cd spack-manyfiles; git status'
Benchmark #1: cd spack-default; git status
  Time (mean ± σ):      3.388 s ±  0.095 s    [User: 256.2 ms, System: 625.8 ms]
  Range (min … max):    3.168 s …  3.535 s    10 runs

Benchmark #2: cd spack-manyfiles; git status
  Time (mean ± σ):     168.7 ms ±  10.9 ms    [User: 98.6 ms, System: 126.1 ms]
  Range (min … max):   144.8 ms … 188.0 ms    19 runs

Summary
  'cd spack-manyfiles; git status' ran
   20.09 ± 1.42 times faster than 'cd spack-default; git status'
```
2021-09-16 09:41:10 -06:00
..
_gh_pages_redirect Use https for links (#19244) 2020-10-09 11:24:09 -05:00
_static make empty _static directory "exist" to git 2014-01-09 14:03:32 +01:00
build_systems Document how to handle changing build systems (#25174) 2021-08-21 11:05:42 -07:00
example_files Implement an optional compiler bootstrapping phase 2019-09-13 22:57:15 -07:00
images docs: document releases and branches in Spack 2020-07-06 11:39:19 -07:00
tables Improve bootstrapping docs a hair (#25962) 2021-09-16 07:02:31 -04:00
_spack_root docs: make docs build relocatable for localized builds 2019-05-26 18:23:44 -07:00
.gitignore tutorial: move tutorial to standalone site (#13450) 2019-10-25 21:49:27 -07:00
analyze.rst Merge pull request #21930 from vsoch/add/spack-monitor 2021-04-15 00:38:36 -07:00
basic_usage.rst Support older py-pygments (#25456) 2021-08-18 09:49:51 +02:00
binary_caches.rst extending example for buildcaches (#22504) 2021-06-14 21:46:27 -07:00
build_settings.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
build_systems.rst Document how to handle changing build systems (#25174) 2021-08-21 11:05:42 -07:00
chain.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
command_index.in Rework command reference in docs, add spack commands command 2018-02-12 20:25:17 -08:00
conf.py Docs: add link to source code (#25088) 2021-08-02 12:36:40 -07:00
config_yaml.rst Make -j flag less exceptional (#22360) 2021-03-30 12:03:50 -07:00
configuration.rst Document cli syntax for environment scopes (#20344) 2021-03-21 10:14:13 +00:00
containers.rst containerize: fix typo in documentation (#22331) 2021-03-16 21:02:26 +00:00
contribution_guide.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
developer_guide.rst Avoid hidden circular dependencies in spack.architecture (#25873) 2021-09-13 11:04:42 -07:00
dockerhub_spack.png spack containerize generates containers from envs (#14202) 2020-01-30 17:19:55 -08:00
environments.rst Add link_type documentation (#25451) 2021-08-17 09:47:26 -07:00
extensions.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
features.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
getting_started.rst Recommend Git's manyFiles feature (#25977) 2021-09-16 09:41:10 -06:00
index.rst Recommend Git's manyFiles feature (#25977) 2021-09-16 09:41:10 -06:00
known_issues.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
Makefile API Docs: fix broken reference targets 2021-07-16 08:30:56 -07:00
mirrors.rst Add doc for mirror of env (#22525) 2021-03-24 20:55:15 +00:00
module_file_generation.svg SC17: reworked module file tutorial section (#5657) 2017-11-12 00:27:20 -08:00
module_file_support.rst Separable module configuration -- without the bugs this time (#23703) 2021-05-28 14:12:05 -07:00
monitoring.rst Adding support for spack monitor with containerize (#23777) 2021-06-17 17:15:22 -07:00
package_list.rst copyrights: update all files with license headers for 2021 2021-01-02 12:12:00 -08:00
packaging_guide.rst Remove references to self.install_test_root from packaging guide (#25238) 2021-08-26 19:22:40 +02:00
pipelines.rst Doc: Note on required changes after merge of reproducible builds (#24347) 2021-06-25 11:02:26 -06:00
repositories.rst Package Repositories docs: num packages has grown (#20735) 2021-01-11 11:00:14 +01:00
requirements.txt Documentation does not build with Sphinx 4.1.2 2021-07-26 13:46:27 -07:00
spack.yaml Documentation does not build with Sphinx 4.1.2 2021-07-26 13:46:27 -07:00
workflows.rst docs: minor grammar fix (#25814) 2021-09-07 09:51:14 +00:00