-
-
Notifications
You must be signed in to change notification settings - Fork 114
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
Feature/yard documentation #85
Feature/yard documentation #85
Conversation
bridgetown-core/lib/bridgetown-core/concerns/site/configurable.rb
Outdated
Show resolved
Hide resolved
bridgetown-core/lib/bridgetown-core/concerns/site/renderable.rb
Outdated
Show resolved
Hide resolved
bridgetown-core/lib/bridgetown-core/concerns/site/renderable.rb
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This looks fabulous! I noticed just a few small things to tweak and made comments. Otherwise LGTM 👍
(or you could keep the PR open if there's something else you want to update docs for…)
Going to go ahead and squash and merge this. I'm not sure when I'll be documenting again, but I dont like leaving branches open as a personal preference. Ill open a new PR when the time comes :) |
Works for me. Thanks @ParamagicDev 👍 |
This is a 🙋 feature or enhancement.
Summary
Adds
yard
toGemfile
Adds a Rake task in
bridgetown-core
for starting a YARD server.Adds
.yardoc
to.gitignore
[bundle exec] rake yard:serve
will create a local server at port 8808.[bundle exec] rake yard:serve YARD_PORT="3000"
will create a local server on port 3000.[bundle exec] rake yard
will generate documentation. Currently it is setup to only parse the files and not generate any documentation.Provides YARD documentation for
bridgetown-core/lib/bridgetown-core/site/concerns
Context
This is part of #47 to help improve internal documentation.