René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Can this repository be made consistent with dev.java?","articleBody":"### Motivation\r\n\r\nI (and I have reason to believe this also applies to other contributors) am confused by inconsistencies between https://dev.java and this repository.\r\n\r\nThis repository seems to be based on an old version of the dev.java site that doesn't have all articles which means that if authors want to use `[link](id:some.article.id)` formatting to link to other articles (which I would consider to be the preferred way of writing links between articles), which leads to either [using full links](https://github.com/java/devjava-content/pull/70/files#diff-d91b81262c60c3b99aec3b51b9f83e8702b9a3a4f8107f5570629104efd343fcR52) or [guessing](https://github.com/java/devjava-content/pull/45#issuecomment-1741274090). Furthermore, some of the articles not being present results in warnings when building this repository. Also, since some article groups are not available in this repository, guesses about that have to be made as well (e.g. [the `Classes and Objects` group](https://github.com/java/devjava-content/pull/45#issue-1917170339)) for the article directory, id of the article and the file name of the article (specifically the number at the beginning).\r\n\r\nAlso, there are some inconsistencies between this repository and the site, for example #101 was fixed on the site but this repository [still contains the old version](https://github.com/java/devjava-content/blob/da4edd1b9b7b4e046076a490765e15d2d5180f6a/app/pages/learn/01_tutorial/03_getting-to-know-the-language/02_basics/02_creating-primitive-types.md?plain=1#L40) and the Javadocs of this repository [still refer to Java 19](https://github.com/java/devjava-content/blob/da4edd1b9b7b4e046076a490765e15d2d5180f6a/app/data/javadoc.json#L2) while the site uses Java 21 which lead to confusion in #97 for example.\r\n\r\n### Suggestion\r\n\r\nBecause of these issues, I suggest that\r\n- [Javadoc definitions](https://github.com/java/devjava-content/tree/main/app/data) are kept up to date (i.e. when these are changed on dev.java, this is also done in this repository).\r\n- If an article that has a version in this repository is changed on https://dev.java, it should also be changed in this repository.\r\n- Create stubs of all articles, especially in article groups. I can understand not wanting to have the content of some articles in this repository due to copyright/licensing but please at least include a file containing the metadata in this repositories for all articles and article groups present in https://dev.java/learn.\r\n\r\nFor example, for the [VSC article](https://dev.java/learn/vscode-java/), I could imagine such a stub look like the following\r\n```\r\n---\r\nid: first_app.vsc\r\ntitle: Building a Java application in Visual Studio Code\r\nslug: learn/vscode-java\r\ntype: tutorial\r\ncategory: start\r\nlayout: learn/tutorial.html\r\nsubheader_select: tutorials\r\nmain_css_id: learn\r\ndescription: \"An IDE (Integrated Development Environment) allows you to quickly program applications by providing multiple utilities for code development, testing, debugging features, etc. Given the increasing popularity of Visual Studio Code as a universal IDE, you can easily develop your first Java project by installing the Oracle Java Platform Extension.\"\r\nlast_update: 2024-04-22\r\n---\r\n\r\n# The content of this article is not available in this repository.\r\n```\r\n(data taken from https://dev.java/learn/vscode-java/)\r\nIf you don't want to include the description in the stub, I could also imagine the empty string being used for that).\r\n\r\nThe most important parts of that are:\r\n- id\r\n- everything related to the article group/layout so that contributors can easily copy and adapt it for their articles.\r\n\r\nbut I think it's useful to be able to copy the metadata from another article in the same group.","author":{"url":"https://github.com/danthe1st","@type":"Person","name":"danthe1st"},"datePublished":"2024-05-29T10:06:03.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/104/devjava-content/issues/104"}