Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • B bootstrap
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 263
    • Issues 263
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 114
    • Merge requests 114
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Package Registry
    • Infrastructure Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • Bootstrap
  • bootstrap
  • Merge requests
  • !12037

Bring back the `/docs` directory

  • Review changes

  • Download
  • Email patches
  • Plain diff
Merged Mark Otto requested to merge docs_dir into master Dec 29, 2013
  • Overview 0
  • Commits 9
  • Pipelines 0
  • Changes 105

This moves all documentation files to a /docs subdirectory to help clean up the file tree. Here are some thoughts on what's changed and why it matters.

  • All .html files, /examples, and Jekyll directories have been moved to a subfolder, /docs.
  • By far the biggest win is organization. It cleans up the file tree for beginners who have no idea what some of this stuff is and makes it easier for us as maintainers (@twbs/team) to stare at this stuff all day.
  • By far the biggest downside is that this duplicates some code. However, I've tried to keep that to a minimum by only bringing over the minified CSS and JS files. All the fonts are duped though.
  • As part of this, the _config.yml file has been cleaned up. Nested configs look way better. I was also able to remove all the exclude lists since the stuff we really need to compile the docs is now all in one spot, free of extra noise.
  • I've also replaced all instances of {{ page.base_url }} with {{ site.baseurl }}. Better to use an official config setting than a custom one on each page. This does, however, mean that folks who fork Bootstrap need to change the baseurl option in Jekyll if they wish to host our docs themselves. I'm not worried in the slightest about this.

By moving the Jekyll folders, our examples, docs assets, HTML files, and docs license to the subdirectory, we effectively lose 13 items from the root directory. The root file tree looks like this now:

├─ dist/
├─ docs/
├─ fonts/
├─ js/
├─ less/
├─ test-infra/
├─ .csscomb.json
├─ .csslintrc
├─ .editorconfig
├─ .gitattributes
├─ .gitignore
├─ .travis.yml
├─ CNAME
├─ CONTRIBUTING.md
├─ Gruntfile.js
├─ LICENSE
├─ README.md
├─ _config.yml
├─ bower.json
├─ composer.json
└─ package.json

It's a bit better, but could still use some cleanup. I'm curious if we could punt any of those other files somewhere else. It'd be great if a repo could just have a .files/ directory for this stuff.

/cc @fat, because <3.

Assignee
Assign to
Reviewers
Request review from
Time tracking
Source branch: docs_dir