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 DOAP usage #3915

Closed
melvo opened this issue Oct 6, 2022 · 4 comments
Closed

Add DOAP usage #3915

melvo opened this issue Oct 6, 2022 · 4 comments

Comments

@melvo
Copy link
Contributor

melvo commented Oct 6, 2022

There is no overview of XEPs ejabberd supports. It could be solved by creating a DOAP file which can be rendered in order to create an overview page.

Here are the needed steps:

  1. Create a DOAP file like QXmpp's DOAP file
  2. Update the DOAP file URL in xmpp.org's listing

Once your changes are merged and deployed, you should see the supported XEPs after clicking Show Supported XEPs on ejabberd's overview page.

@melvo
Copy link
Contributor Author

melvo commented Oct 6, 2022

@weiss Here is the issue we talked about :)

@badlop
Copy link
Member

badlop commented Nov 7, 2022

Erlang modules in ejabberd use a custom module attribute -protocol to define what XEPs and RFCs that module implements (and general protocols are listed in ejabberd.erl). This was first implemented in 0c725b5. I am not aware this was used anywhere, it was just simply defined for our human knowledge and consulting.

Now in 4542bcb I've written a script that extracts this information from -protocol attribute and generates ejabberd.doap. It includes protocol number, protocol version, and in what source file it is declared.

I've pushed this URL to xmpp.org git repository as you explained, and now this information is listed in XMPP Servers: ejabberd

It doesn't fill the status (partial | complete), software version, or any other arbitrary comment about the implementation. Maybe that could be defined as additional, optional arguments in the -protocol attribute.

That would require a smarter script to parse properly the -protocol attribute. Let's keep this issue open to track that improvement.

@badlop badlop self-assigned this Nov 7, 2022
@badlop
Copy link
Member

badlop commented Nov 7, 2022

Ok, now the script that extracts information from modules into ejabberd.doap can parse status, software version and comments. I also added version information since 2014. All those news will appear in xmpp.org when the website gets automatically updated in the next days I guess.

@badlop badlop closed this as completed Nov 7, 2022
@melvo
Copy link
Contributor Author

melvo commented Nov 8, 2022

@badlop Really great, thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants