Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: fix missing links and add consistency #6177

Merged
merged 1 commit into from
Aug 26, 2020
Merged

Conversation

hacksparrow
Copy link
Contributor

Addresses #6176.

There were some inconsistencies in use of plurals, causing the links to fail. I have also renamed the title "Behind the scenes" to "Concepts", as it should be.

On my local machine, after running npm run docs:prepare, I could not start the server with npm run docs:start due to this error:

Could not locate the included file 'readmes/loopback-example-angular.md' in any of ["/Users/yaapa/projects/loopback-next/docs/_preview/_includes", "/Users/yaapa/.rbenv/versions/2.7.1/lib/ruby/gems/2.7.0/gems/jekyll-theme-primer-0.5.4/_includes"]. Ensure it exists in one of those directories and is not a symlink as those are not allowed in safe mode. (IOError)

I had to comment out {% include readmes/loopback-example-angular.md %} on docs/_preview/pages/readmes/loopback-next/sandbox/loopback.io/README.md to get it working.

I don't know if the remote doc server will encounter the same error or not. If it is going to encounter the same error, land this only after fixing that issue first.

Checklist

  • DCO (Developer Certificate of Origin) signed in all commits
  • npm test passes on your machine
  • New tests added or existing tests modified to cover all changes
  • Code conforms with the style guide
  • API Documentation in code was updated
  • Documentation in /docs/site was updated
  • Affected artifact templates in packages/cli were updated
  • Affected example projects in examples/* were updated

👉 Check out how to submit a PR 👈

@hacksparrow hacksparrow self-assigned this Aug 22, 2020
Copy link
Contributor

@jannyHou jannyHou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍 Thank you @hacksparrow

@@ -13,24 +14,24 @@ responsibilities for typical API and/or Microservice applications.

- [**Application**](Application.md): The central class for setting up all of
your module’s components, controllers, servers and bindings. The Application
class extends [Context](Context.md) and provides the controls for starting and
stopping its associated servers.
class extends [Context](./Context.md) and provides the controls for starting
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nitpick, it's ok to keep as Context.md for consistency

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually I had updated to relative paths, but undid it after seeing a lot more of non-breaking non-relative paths. It would be inconsistent to update only some of them in this PR; and I did not want to get into updating everything, you never know what new problems might be encountered. I wanted to make this PR a quick one. Let's keep "use of relative paths on all doc pages" as a task for another PR.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, I got what you mean. Updating.

Fixed missing links and added consistency.

Signed-off-by: Yaapa Hage <[email protected]>
@dhmlau dhmlau merged commit 7f983d3 into master Aug 26, 2020
@dhmlau dhmlau deleted the docs/concept-links branch August 26, 2020 01:57
@dhmlau dhmlau mentioned this pull request Aug 26, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants