-
Notifications
You must be signed in to change notification settings - Fork 25
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
Refactor Middleman Blogging for making guides #12
Conversation
Also remove nokogiri
@jakerenzella It would be good to go through this with you so we can update how contributors (I'm thinking of #8, #10 and #9) can refactor their guides into the new format. Alternatively, we can merge these PRs first, and then merge in #12 and refactor these new guides into the new format. |
@jakerenzella @macite Feedback on these changes (i.e., anything that may be now missing) would be great if you get a chance to have a look. |
@alexcu Will review 👍 |
Now that this PR has been merged, @isdampe you may want to review the guides you published a while ago and see if you would like to update any authorship details in the new format 😊 As for #9 and #10, @AkshatBajaj and @drosborn you will need to update the PRs to reflect the new changes (just refer to the new guides for writing blog posts and ensure your post contents are consistent with them 😊). If you no longer want to contribute these blogs, you can close them or we can publish them on your behalf :) |
Thanks for the heads up @alexcu I will check it out when I have some spare minutes :) |
Thanks @alexcu I will make changes in the guide. |
I've taken a look this morning - the published guides I authored seem to still fit in well, in terms of context. Good job on the updated contributing guide! |
This PR refactors Middleman Blogging into the Guides.
The directory structure has been modified to make the root publication directory
articles
, which encompassguides
,installation
andcontribution
.To create a guide run:
This will produce a new guide with a timestamp under
articles/guides
. The[tag]
must be set to anapi_group
, such as the existingjson
,utilities
, anddatabase
guides. The basic structure of a guide is a Markdown file that contains the following frontmatter:Additionally, this PR add some minor refactors and enhancements to looks, such as:
Also fixes #11 (thanks @isdampe for reporting this!)
Still left as WIP: