Skip to content

Troubleshooting

Dmitry Shevtsov edited this page Jan 6, 2022 · 5 revisions

I have signed the Adobe CLA twice and its check still requires signing it

Sign the Adobe CLA!

No signed agreements were found. ...

Check if you entered your GitHub username correctly. Example solution.

The file doesn’t exist but the page-builder/ folder is a separate repo - but it’s not updating. How can I force a pull/update to get the file in question?

Run in your terminal rake update:all. Also, applicable to other subrepositories: mbi and mftf.

When I run rake update:all, git notifies me that I have to commit something

rake update:all runs git pull on default branches for repositories. Default branches are the branches defined in the Docfile.yml. They are always protected. Direct committing into protected branches is strictly forbidden. And there is a reason for it. When you add a commit to your default branch, you cannot push it, BUT that commit will become a part of your new branch.

When git shows you that there is something wrong after rake update:all, it means that content in your default branch has been changed. You never commit changes to a default branch!

Okay, but I already committed such changes to a default branch

Reset the corresponding default branches in devdocs and subrepositories where you directly added those commits.

On devdocs

git fetch
git checkout master
git reset --hard origin/master

In subrepositories

If you work in subrepositories (any local-only branches, stashes):

cd <directory of a subrepo from Docfile>
git fetch
git checkout <branch from Docfile>
git reset --hard origin/<branch from Docfile>

If you never work with subrepositories:

rake multirepo:reinit

CAUTION: multirepo:reinit will remove all the directories and associated git repositories listed in Docfile.

Psych::SyntaxError when running commands to preview or build the site

Psych is a YAML parser and emitter. Psych::SyntaxError points to the file with invalid YAML syntax.

(.../devdocs/src/_data/whats-new.yml): did not find expected key while parsing a block mapping at line 5070 column 3 (Psych::SyntaxError)

YAML linter or validator can help with this.