Add a new section in the Docs for other JSON Schema resources

[benjagm]

Description

If would be great to have resources section to show articles, papers, books podcasts and any other type of resources. We'll use json to store the data and provide dynamic UX.

Content types:

• Articles
• Books
• Courses
• Videos
• Podcasts
• Papers

Data structure example:

- title: Using JSON Schema
  url: https://books.apple.com/us/book/using-json-schema/id903248630
  year: 2014
  type: books
  summary: Learn and Apply JSON Schema by Example, with JavaScript (Node.js) and Python Programs
- title: JSON at Work
  url: https://www.oreilly.com/library/view/json-at-work/9781491982389/
  year: 2017
  type: books
  summary: A comprehensive overview of the JSON ecosystem, including JSON Schema

An amazing source of information will be: https://github.com/sourcemeta/awesome-jsonschema/blob/master/data.yaml

A possible prototype for this may be:

Resources menu:

Resource category page (example):

Do you think this work might require an Architectural Decision Record (ADR)? (significant or noteworthy)

No

[benjagm]

I have some progress in this draft PR #281 but I'd love to have someone to continue the development.

[Gmin2]

I have some progress in this draft PR #281 but I'd love to have someone to continue the development.

@benjagm can i help you with it?

[benjagm]

can i help you with it?

@Min2who of course! Thanks a lot!! Please go ahead. (check my draft PR with the side menu logic)

[Sanket-0510]

@benjagm can I look into this?

[Akshaybagai52]

Hey @benjagm
Can I work on this issue
Thanks

[benjagm]

@Akshaybagai52 Available to work on this one?

[Atharva-Kanherkar]

Hi, if no one is working on this, i would like to work on this.
Seems like a good issue to get hands on with the codebase!

@Akshaybagai52 Available to work on this one?

[benjagm]

Please go ahead @Akshaybagai52 ! Thanks for your support!

[Akshaybagai52]

Thanks @benjagm for assigning this issue would share the progress

[Akshaybagai52]

Hey @benjagm
is this looking good ?

and can you suggest me good icon if there is any already present in the repo because I've find some but they are big in size
and right now the routes I made is like that

is these correct or you want me to change the route name
Thanks

[benjagm]

is this looking good ?

Looks good but we'd like the categories to be loaded dynamically from the YAML in the nodes "name"

[Akshaybagai52]

Okay I will check that

is this looking good ?

Looks good but we'd like the categories to be loaded dynamically from the YAML in the nodes "name"

[benjagm]

The YAML does not exists. You'll need to create or import it from : https://github.com/sourcemeta/awesome-jsonschema

And put it into the data folder.

[Akshaybagai52]

The YAML does not exists. You'll need to create or import it from : https://github.com/sourcemeta/awesome-jsonschema

And put it into the data folder.

Is there any code related to YAML which is already present in the "website" repo because I've checked the code for docs section it is using same thing as I shown above

[benjagm]

section it is using same thing as I shown above

Your approach to create new static links in the side bar is correct, however for this feature we need to dynamically create those links depending on the database with resources available in a new yaml file we are going to create inside the folder "data". You'll need to identify the types of resources available and build the menu:

- title: Using JSON Schema
  url: https://books.apple.com/us/book/using-json-schema/id903248630
  year: 2014
  type: books
  summary: Learn and Apply JSON Schema by Example, with JavaScript (Node.js) and Python Programs
- title: JSON at Work
  url: https://www.oreilly.com/library/view/json-at-work/9781491982389/
  year: 2017
  type: books
  summary: A comprehensive overview of the JSON ecosystem, including JSON Schema

And we'll import/convert data from here:
https://github.com/sourcemeta/awesome-jsonschema/blob/master/data.yaml

Before start coding, make sure you understand the requirements described in the body of the issue. The whole point of this feature is dynamically get data from that yaml and build the menu and the resource page with search engine.

If this is not clear in the description of the issue, happy to provide more clarifications.

[Akshaybagai52]

Okay thanks for your clarification will work on this and ask you further questions if I have any

[Akshaybagai52]

Hey @benjagm I'm able to get the details of the data.yaml file now is there any design of each route so that I can make the design of each page as well
Thanks

[benjagm]

@Akshaybagai52 great progress! Please refer to the low-fi prototype provided in the body of the issue to have a sense about the UX/UI.

Feel free to be creative and evolve to make it much more cool.

[Akshaybagai52]

@Akshaybagai52 great progress! Please refer to the low-fi prototype provided in the body of the issue to have a sense about the UX/UI.

Feel free to be creative and evolve to make it much more cool.

Thanks for suggestions. I will create the UI accordingly and it will take longer time because I also need to understand repo code

[Akshaybagai52]

Hey @benjagm can you review this PR #395 right now only articles and books sections are working once one of them will become perfect according to review then I will fix remaining one
thanks

[Akshaybagai52]

Hey @benjagm did you check this PR

[benjagm]

Can you please make sure the target branch of this PR is : https://github.com/json-schema-org/website/tree/web-release-3?

Reference docs: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-base-branch-of-a-pull-request

[benjagm]

@Akshaybagai52 are you still working on this issue?

[Akshaybagai52]

@Akshaybagai52 are you still working on this issue?

Yes I'm working on it will raise PR today

[benjagm]

Closed as completed.