Skip to content

Conversation

@hubwriter
Copy link
Contributor

@hubwriter hubwriter commented Oct 14, 2021

This is a sister PR to Calum's PR #6860 which adds new articles for Ruby,
and a companion to this PR for the changes to the articles on docs.github.com.

This PR mentions Ruby in various existing articles.
See the 2nd half of the documentation plan (https://github.com/github/docs-content-strategy/blob/main/content-design-plans/docs-content/5017/plan.md#on-codeqlgithubcomdocs) for details of the changes.

NOTES

  • I haven't added a "built-in support" table for Ruby on the "Supported languages and frameworks" (i.e. like this one for JavaScript. I mentioned this to @calumgrant and it sounds like we can leave this out for now.

@shati-patel:

TODO: Once Calum's PR is merged EDIT: now done ✅
update
docs/codeql/codeql-language-guides/codeql-for-ruby.rstadding this line:
.. include:: ../reusables/ruby-beta-note.rst
Adding it to Calum's PR now won't work as the reusable is in my PR.

@hubwriter hubwriter marked this pull request as ready for review October 14, 2021 16:18
calumgrant
calumgrant previously approved these changes Oct 15, 2021
Copy link
Contributor

@calumgrant calumgrant left a comment

Choose a reason for hiding this comment

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

LGTM, Thanks!

lecoursen
lecoursen previously approved these changes Oct 15, 2021
shati-patel
shati-patel previously approved these changes Oct 15, 2021
Copy link
Contributor

@shati-patel shati-patel left a comment

Choose a reason for hiding this comment

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

(wrong "@Shati" pinged in the OP 😉 )

I'll take a look along with my changes to the automation - if anything needs to be added manually, I'll make sure to do that!

turbo
turbo previously approved these changes Oct 18, 2021
Copy link
Member

@turbo turbo left a comment

Choose a reason for hiding this comment

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

LGTM

turbo
turbo previously approved these changes Oct 19, 2021
Copy link
Member

@turbo turbo left a comment

Choose a reason for hiding this comment

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

LGTM (still 🙂)

@turbo
Copy link
Member

turbo commented Oct 19, 2021

@calumgrant What's the minimum Ruby version we support? What are the glibc requirements?

@calumgrant
Copy link
Contributor

In terms of Ruby version, there is no minimum version.

For the public beta, there will be a minimum supported version of glibc - TBD. (I'm still investigating this).

The the GA, we hope to make this more robust by linking glibc statically. Tracked in https://github.com/github/codeql-team/issues/550

@calumgrant
Copy link
Contributor

We require glibc 2.17

@hubwriter
Copy link
Contributor Author

We require glibc 2.17

I'm not sure where this should be documented for Ruby. I can't find a similar requirement for other languages in the docs on https://codeql.github.com/docs/

@jf205 / @shati-patel - do you have a view on where to document this 👆?

@shati-patel
Copy link
Contributor

We require glibc 2.17

I'm not sure where this should be documented for Ruby. I can't find a similar requirement for other languages in the docs on https://codeql.github.com/docs/

@jf205 / @shati-patel - do you have a view on where to document this 👆?

We have a table of supported languages and compilers. Maybe there should be an entry for Ruby and glibc 2.17 there?

(The source file is https://github.com/github/codeql/blob/main/docs/codeql/support/reusables/versions-compilers.rst)

@turbo
Copy link
Member

turbo commented Oct 20, 2021

We should def add it, as it has been causing issues for customers in the private beta. We can flesh this out for other languages over time.

@hubwriter
Copy link
Contributor Author

@shati-patel / @turbo - Thanks
I did wonder about that table, but it doesn't have a column for requirements (maybe it should?).

I think I'll add a footnote for Ruby.
Is this sufficient: "Requires glibc 2.17" ?

Copy link
Member

@turbo turbo left a comment

Choose a reason for hiding this comment

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

LGTM

@hubwriter hubwriter merged commit 12e56ec into main Oct 22, 2021
@hubwriter hubwriter deleted the hubwriter/codeql-ruby-support branch October 22, 2021 10:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants