Skip to content
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

add a visual timeline based on history page (created by mogztter) #11

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

mojavelinux
Copy link
Member

  • created with Excalidraw
  • add optimized image, thanks to tinypng.com

Extracted from #5

- created with Excalidraw
- add optimized image, thanks to tinypng.com
@ggrossetie
Copy link
Member

Looking at the timeline again, I think we could improve it by using three "streams"

  • AsciiDoc.py
  • Asciidoctor community (Asciidoctor Ruby, AsciidoctorJ, Asciidoctor.js)
  • AsciiDoc Working Group

We could also probably use dynamic column width depending on how much happened in a given year (similar to https://recherche.julie-blanc.fr/timeline-publishing/)

@ggrossetie
Copy link
Member

And if we really need to attach an event to Asciidoctor Ruby, AsciidoctorJ or Asciidoctor.js we could use a color code (but I don't think that would be necessary)

@mojavelinux
Copy link
Member Author

I also added some more detail to the timeline in the docs that will hopefully make it easier to find the information to add.

@mojavelinux
Copy link
Member Author

Btw, there's now an Excalidraw plugin available for IntelliJ. https://plugins.jetbrains.com/plugin/17096-excalidraw-integration

@ggrossetie
Copy link
Member

Here's another proposal:

asciidoc-history

  • Use emojis to identify projects
  • Title and subtitle on chronological points
  • Vertical text (tilted) in the header
  • Larger (double size) 2013-2014 years

I didn't add all the history but I think it gives us more room.
We could add some background color to make it less plain (black and white).

@mojavelinux
Copy link
Member Author

I like the direction you are headed.

Larger (double size) 2013-2014 years

That really was a busy time 😱

I think if we're going to give AsciiDoc.py a row, we need to address when Asciidoctor became the official reference implementation of AsciiDoc and steward of the AsciiDoc language definition (before the initial contribution).

We could also mention when AsciiDoc.py was moved to asciidoc-py (thus vacating the asciidoc org on GitHub).

@mojavelinux
Copy link
Member Author

One idea to make more room would be to make time vertical instead of horizontal. There are only a few categories and lots of years, so it would give us more room to groooooooooooooow.

@ggrossetie
Copy link
Member

Another idea I had was to use the Asciidoctor row as a graph axis to draw the download/usage numbers.
I think it could look cool but:

  • I don't think if it would be very readable (I guess we would have to try to find out)
  • If we want to show more than one number (i.e., for instance gem downloads and npm downloads) on the same graph it might look weird (scale issues)

@ggrossetie
Copy link
Member

That really was a busy time

Indeed!
But it's biased because we are mostly talking about first commit or first release. Other years might have been busier but we just don't see it because we were busy maintaining existing projects (implementing a bunch of new features, fixing bugs...) but we didn't create new projects.

I think if we're going to give AsciiDoc.py a row, we need to address when Asciidoctor became the official reference implementation of AsciiDoc and steward of the AsciiDoc language definition (before the initial contribution).

We could add a chronological point in the AsciiDoc.py row to mention that the project was declared "legacy implementation" (maintenance mode).

We could also mention when AsciiDoc.py was moved to asciidoc-py (thus vacating the asciidoc org on GitHub).

I know it's a big deal for us right now but not sure if we should include it.

One idea to make more room would be to make time vertical instead of horizontal. There are only a few categories and lots of years, so it would give us more room to groooooooooooooow.

I would prefer to keep the timeline vertical. We can squeeze or stretch columns as needed.

@mojavelinux
Copy link
Member Author

We could add a chronological point in the AsciiDoc.py row to mention that the project was declared "legacy implementation" (maintenance mode).

💯

@ggrossetie
Copy link
Member

Another idea I had was to use the Asciidoctor row as a graph axis to draw the download/usage numbers.

asciidoc-history-download-stat
asciidoc-history-download-stat-full

@mojavelinux
Copy link
Member Author

That is absolutely fascinating. What a brilliant idea. 💡

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.

2 participants