jekyll-gist
RDoc
jekyll-gist | RDoc | |
---|---|---|
1 | 8 | |
264 | 820 | |
0.0% | 0.1% | |
0.0 | 8.7 | |
almost 4 years ago | 2 days ago | |
Ruby | Ruby | |
MIT License | Ruby License |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
jekyll-gist
-
Building Jekyll-Twitch, the gem
Jekyll-YouTube Jekyll-Twitter Jekyll-Gist (This one is maintained by Jekyll)
RDoc
-
Xeme: I'd value your opinion on my new Ruby gem
In addition to project documentation, you've included a lot of code comments. You could adopt a standardized format and use it to generate API documentation. RDoc and YARD are two options. If I were reviewing this code at work, I would probably ask you to remove comments that explain what, not why.
-
The right is on the left
That turns out to be a pretty common use case for markdown. Github, for example, renders your README.md is part of a git repo's "home" page. It's also common to have tooling that parses specially formatted comments in your source code and produce a documentation bundle, usually as a web page (ex. RDoc, YARD, JSDoc, etc.).
-
RDoc questions
I have an open (draft) documentation PR for RDoc over at GitHub (https://github.com/ruby/rdoc/pull/824) that has six unanswered questions. These are embedded in the committed text itself, and each is labelled as "Reviewers: ...."
- ¿Por qué aprender Ruby en 2021?
-
Generate API Docs
If you want to document your whole code base you should check https://github.com/ruby/rdoc
-
CVE-2021-31799: A command injection vulnerability in RDoc
I suspect the fix is to remove_unparseable, and the repository, like the CVE, just hasn't been updated yet.
-
Building Jekyll-Twitch, the gem
RDoc We'll use this gem to document our TwitchTag.rb class.
What are some alternatives?
RSpec - RSpec meta-gem that depends on the other components
YARD - YARD is a Ruby Documentation tool. The Y stands for "Yay!"
jekyll-youtube - :tv: Generate embed html snippets for Youtube URLs
Asciidoctor - :gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
jekyll-katex - [DEPRECATED] Jekyll plugin for easy server-side math rendering via KaTeX
Apipie - Ruby on Rails API documentation tool
jekyll-twitch - Embed Twitch clips, VODs, and broadcasts in your Jekyll sites.
grape-swagger - Add OAPI/swagger v2.0 compliant documentation to your grape API
jekyll-notion - Use Notion as a CMS for Jekyll.
Annotate - Annotate Rails classes with schema and routes info
jekyll-asset-post-processor - Process then suffix your Jekyll assets with cache busting version hashes
rspec_api_documentation - Automatically generate API documentation from RSpec