DEPRECATION NOTICE: dropping git submodules for Bootstrap and Font Awesome

[chalin]

Some time towards the end of the next quarter (22Q2), we will eliminate the Bootstrap (BS) and Font Awesome (FA) git submodules (#948).

Why this change?

As explained in #870 (comment), the use of git submodules for importing BS & FA is mainly historical. Docsy no longer needs to use these submodules as part of its build process (as of #904). In fact, the Docsy User Guide now builds using BS & FA from NPM packages (via Docsy).

When will the BS & FA git submodules be eliminated?

This is already successfully implemented in PR #889 (as evident by the successfully built User Guide), but we're giving projects time to adjust to the change. The PR will be merged towards the end of 22Q2.

How will this impact my project?

Moving forward, you'll need to decide how your project with use/import Docsy by choosing in one of the following ways:

• Docsy as a Hugo modules. For details, see Docsy as a Hugo module #849.
• Docsy as an NPM package. For details, see Support use of Docsy as an NPM package #949.
• Continue to clone the Docsy repo (into, say, themes/docsy), but you'll need run the following initialization commands after cloning and/or updating your clone:

  $ cd themes/docsy
  $ npm install

More details will follow after Docsy 0.2.0 is release, which is currently planned for the end of 22Q1.

[chalin]

Hi all: just a heads up that #948 has landed on the main branch and is planned for the next release. Work on #949 is forthcoming.

[chalin]

• This has landed in release 0.4.0
• For details see Release 0.4.0 #1079