Skip to content

Move “Online Courses” documentation to a dedicated page #2287

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

Merged
merged 3 commits into from
Jan 17, 2022

Conversation

julienrf
Copy link
Contributor

@julienrf julienrf commented Jan 5, 2022

The documentation about the Scala Center’s MOOCs was mixed with other online resources, in https://docs.scala-lang.org/learn.html:

Screenshot 2022-01-05 at 16-42-42 Online Resources

We moved it to a new page at https://docs.scala-lang.org/online-courses.html:

Screenshot 2022-01-05 at 16-32-53 Online Courses from The Scala Center

Note that the new page uses the Scala 3 colors since the courses mainly use Scala 3.

The page /learn.html now contains a link to /online-courses.html:
Screenshot 2022-01-05 at 16-31-51 Online Resources

(also note that the layout of the page is different and now shows the table of contents on the right)

We have also added entries to the navigation menus:

Screenshot from 2022-01-05 16-31-01
Screenshot from 2022-01-05 16-31-27

In the /online-courses.html page, we have moved the section “Learning Paths” up to the beginning, and we have included a general video about Scala Center MOOCs (the video is not available yet) :

Screenshot 2022-01-05 at 16-32-53 Online Courses from The Scala Center


This PR requires one more action from visitors to see the Scala Center courses. Indeed, the path used to be index.html -> learn.html. It is now index.html -> learn.html -> online-courses.html. We could address this issue by putting a link to the online courses on the index.html page.

Update: I pushed a commit that includes back a link to /online-courses.html from the landing page:

Screenshot from 2022-01-05 17-40-00

However, I am not very happy with it because before the commit the whole gray rectangle was a link, whereas with the commit users now have to click exactly on the item title.

@julienrf julienrf requested a review from bishabosha January 5, 2022 15:54
@SethTisue
Copy link
Member

Great idea. I've often wanted to have a link to send people that just shows the Center's courses, and I never had one.

@SethTisue
Copy link
Member

SethTisue commented Jan 5, 2022

While I've got your attention, have you considered a new blog post about the courses? (Sharing whatever news there is to share, yes, but primarily simply reminding everyone, especially folks who are new to the community, that the courses exist and are being kept up-to-date.)

Copy link
Member

@bishabosha bishabosha left a comment

Choose a reason for hiding this comment

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

the structural changes seem fine, however as you mentioned every single item on the main docs page is no longer a button, you have to click exactly on the title in each box

- Include video about Scala Center MOOCs in general
- Move “Learning Path” section up to the beginning of the page
- Add “Online Courses” entry to the navigation menus
@julienrf
Copy link
Contributor Author

I agree @bishabosha, I have removed the last commit to revert that change only. Instead, I replaced the item “Online Resources” with “Online Courses”, and I included back a link to “Online Resources” from the page “Online Courses” (in the section at the bottom of the page).

I have also included the actual video.

Here is a screenshot of the landing page:

Screenshot 2022-01-17 at 17-50-46 Documentation

And the Online Courses page:

Screenshot 2022-01-17 at 17-51-17 Online Courses from The Scala Center

@julienrf julienrf marked this pull request as ready for review January 17, 2022 16:51
@julienrf julienrf requested a review from bishabosha January 17, 2022 16:51
Copy link
Member

@bishabosha bishabosha left a comment

Choose a reason for hiding this comment

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

Looks good mostly, however now there is a divide: online courses appears in "First Steps" for Scala 2, but "More Detailed Information" for scala 3.

@julienrf
Copy link
Contributor Author

True, the Scala 3 front page needs more work, but I would like to do it in a separate PR.

@bishabosha bishabosha self-requested a review January 17, 2022 17:12
@julienrf julienrf merged commit 5b5741c into scala:main Jan 17, 2022
@julienrf julienrf deleted the online-courses branch January 17, 2022 17:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants