Updating Docsy

Keeping the theme up to date.

We hope to continue to make improvements to the theme along with the Docsy community. If you have cloned the example site (or are otherwise using the theme as a submodule), you can update the Docsy theme yourself.

Updating Docsy means that your site will build using the latest version of Docsy at HEAD and include all the new commits or changes that have been merged since the point in time that you initially added the Docsy submodule, or last updated. Updating won’t affect any modifications that you made in your own project to override the Docsy look and feel, as your overrides don’t modify the theme itself. For details about what has changed in the theme, see the list of Docsy commits.

Depending on how you chose to use Docsy, follow the corresponding steps to update the theme:

Update a Docsy submodule

If you are using the Docsy theme as a submodule in your project (for example, if you’ve copied our example site), you update the submodule:

  1. Navigate to the root of your local project, then run:

    git submodule update --remote
    
  2. Add and then commit the change to your project:

    git add themes/
    git commit -m "Updating theme submodule"
    
  3. Push the commit to your project repo. For example, run:

    git push origin master
    

Update your Docsy clone

If you cloned the Docsy theme into the themes folder in your project, then you use the git pull command:

  1. Navigate to the themes directory in your local project:

    cd themes
    
  2. Ensure that origin is set to https://github.com/google/docsy.git:

    git remote -v
    
  3. Update your local clone:

    git pull origin master
    

If you have made any local changes to the cloned theme, you must manually resolve any merge conflicts.



Last modified July 2, 2019: fixed some shonky formatting (038d4b8)