Rails: Update link texts to improve accessibility

mathdebate09 commented 3 days ago

Because

Revise the link texts as per the instructions given in the issue.

This PR

Update link texts to the sections Websockets and Action Cable && Basic Messaging App (actioncable_lesson.md) && Project: Rails Final Project && Conclusion as per the given spreadsheet

Issue

Related to #28290

Additional Information

nil

Pull Request Requirements

[x] I have thoroughly read and understand The Odin Project curriculum contributing guide
[x] The title of this PR follows the location of change: brief description of change format, e.g. Intro to HTML and CSS lesson: Fix link text
[x] The Because section summarizes the reason for this PR
[x] The This PR section has a bullet point list describing the changes in this PR
[x] If this PR addresses an open issue, it is linked in the Issue section
[x] If any lesson files are included in this PR, they have been previewed with the Markdown preview tool to ensure it is formatted correctly
[x] If any lesson files are included in this PR, they follow the Layout Style Guide

mathdebate09 commented 3 days ago

Should I fix the linting issues as well? The issue mentioned to let them be

MaoShizhong commented 3 days ago

For these, I can trust you to address any reasonable lint errors. Most should be fixable using the appropriate npm fix scripts, then if any obvious ones remain, you can manually fix those.

Feel free to ask any questions if you encounter any less clear lint errors.

mathdebate09 commented 3 days ago

Yes they were really easy fixes, but the linter still screams, it requires a section on lesson overview, can i work on it as well? Also there's an error which didn't make sense to me

ruby_on_rails/mailers_advanced_topics/websockets_and_actioncable.md:320 TOP004/lesson-headings Required heading structure [Expected: h4 heading; Actual: h3 heading] https://github.com/TheOdinProject/curriculum/blob/main/markdownlint/docs/TOP004.md

It's a Knowledge Check section which is always written with h3, should i change it to h4 as per the linter?

Edit: I forgot to ask for another change i made, in the ruby_on_rails/mailers_advanced_topics/websockets_and_actioncable.md file, there were clashing headers with both having title as Connections (lines 63 and 104), I've made them a bit more descriptive and thus no clashing links and updated link in Knowledge Check as well.

mathdebate09 commented 3 days ago

I believe this should do it, also I moved the Conclusion up, right before Assignments section to adhere to the lesson structure.

TheOdinProject / curriculum