XSF Discussion - 2021-11-07

Dear XEP folks :-) since the great work of Daniel Brötzmann (aka wurstsalat3000) not just brought us a new website generator (Hugo) but also Mermaid visualizations, I would like to invite you to join the discussion on how to meaningful show basic connection between RFCs and XEPs as an overview of how to get started with the XMPP protocol. I think this will help understanding, reviewing but also onboard newcomers to XMPP and make the whole protocol more attractive and easier to understand. Let me know if you think it is a good idea! I don't know yet how it could look like and how we should discuss a draft, but if you wanna to crazy and provide a direct draft - please go ahead. Otherwise you reach us in the main MUCs. Maybe you can write some connections you think are important as: XEP-0001 --> XEP-0002 <--> XEP-0003 (add comments anywhere you like) Then I will try to visualize it meaningful. It does not need to be complex and detailed by hard. Let's start simple. Here is a pad if that helps: https://yopad.eu/p/XEP-overview-visualization-365days Cheers, Eddie (emus) - https://gohugo.io/ - https://mermaid-js.github.io/mermaid/#/

wurstsalat

https://cerdale.zash.se/s/M4j_eRjVT_pINO5x/G7yqv5urukJyZ9Q7EZT3Ew3oG6dwjJCBIokdBVji7r8.svg

Like this madness?

I have one of those somewhere I generated for every single XEP. It was not pretty.

I like the colors though, I should add color support.

https://cerdale.zash.se/s/3Wzqkblk35MWAWB8/mkdepgrap.sh

Yeah, I just tried it with ALL the XEPs. I definitely won't be able to sleep now.

ahh nice, lets try this from here 🙂 wurstsalat suggested we should have some "connector references" in the XEPs

Zash, can you forward the picture to the mail?

XEPs do already contain Dependencies, Supersedes, Superseded By in the metadata, presented boringly in https://xmpp.org/extensions/xep-0030.html#appendix-docinfo

Plus references and other links

Seems this mermaid thing has a different syntax than the Graphviz tools I've been using all my life.

you dont need to do it, rather describe what you woudl like to see

but why show supersedes?

https://share.samwhited.com/sam/JmRq3gTBqPGSkke3/all.svg

Warning: cursed image.

I did a small tool also: https://codeberg.org/DebXWoody/snippets/raw/branch/master/xep-dot.c - but didn't include the dependencies. When I remember well, it will show the XEPs in colors depending on the status.

DebXWoody?: Could you show a rendered image of it?

https://codeberg.org/DebXWoody/snippets/raw/branch/master/xep-dot.png

Puh, I think I dont understand this exactly. What order is this?

There is no order,yet. The idea was to build a diagram of all XEPs depending on status and dependencies. The program scans all XEPs file and looks for the status. Each status has a own color. What's missing is the read the dependencies. If this will be added, you will get a graph which shows colored boxes with an arrow to another box.

I think we might rename us here the same as we have in Fosstodon: XSF: XMPP Standards Foundation https://nitter.nixnet.services/xmpp what do you think?

Last reminder that our Board and Council application period end this week. If you want to apply then add your application here today: https://wiki.xmpp.org/web/Board_and_Council_Elections_2021

ah nice jcbrand is applying

but only four applications each…

does it need to be 5?

well

kind of

not sure what happens when we have less than five applicants

Link Mauve, wanna run? ;)

One of them serves twice

I threw my hat in the ring for council but we need at least 1 more cause uncontested elections are boring