Skip to content

Discourse migration - First draft of roadmap and user guide #45

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

Merged
merged 5 commits into from
Jun 10, 2021

Conversation

ChristianKuehnel
Copy link
Collaborator

@ChristianKuehnel ChristianKuehnel commented Jun 7, 2021

roadmap

This should explain the steps for the migration. This is mostly for the people working on the migration.

user guide

This is intended for the community to answer the questions I would expect them to have.

This is related to #6 and #37.

@ChristianKuehnel ChristianKuehnel changed the title First draft of roadmap and user guide Discourse migration - First draft of roadmap and user guide Jun 7, 2021
@tstellar
Copy link
Collaborator

tstellar commented Jun 7, 2021

@joker-eph That's a good question. @ChristianKuehnel We should add this to a TODO for the Discourse migration, what do you think is the best way to do this, a github issue?

[is not supported](https://meta.discourse.org/t/selecting-multiple-category/116827).

**TODO:** The documentation says tags can be used to achieve a similar outcome.
However they don't say how to do that.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are other ways to emulate cross-posting. For example, you can have an 'announce' category or something that everyone is automatically subscribed too. I think the important thing about cross posting is that it reaches people who may be subscribe only to a single category. Where the archive of the discussion ends up is not all that important.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not convinced that this is addressing "cross-posting" in general.
For example some technical discussion that starts on cfe-dev gets cross-posts to llvm-dev, but they aren't "announcements" neither they are suitable for a global category (irrelevant for lldb, lld, mlir, etc.).


### What is the reason for the migration?

see [this email](https://lists.llvm.org/pipermail/llvm-dev/2021-June/150823.html)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should expand this section and list some of the features we get from using Discourse that we can't get from mailman.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree, can you propose something in a PR? I merged this document to main branch.

@ChristianKuehnel ChristianKuehnel merged commit 4506105 into llvm:main Jun 10, 2021
@ChristianKuehnel ChristianKuehnel deleted the discourse-1st-draft branch June 10, 2021 09:18
@ChristianKuehnel
Copy link
Collaborator Author

I'm merging the current state of the document, so we can split up the discussions. Please do create PRs for the changes you would like to make.

* You can filter incoming emails in your email client by category using the
`List-ID` email header field.

## Mapping of mailing lists to categories
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might be worth noting here that we have a lot more specific categories on Discourse than we previously had mailing lists for. Does it make sense to mention all the "new" categories that were previously discussed on the same mailing list? Or at least mention it in writing. In my opinion this is an organizational benefit of Discourse.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, can you propose something? I have to admit, I don't really have a good overview of the mapping.

I merged the file to the main branch, feel free to create a PR for that.

@sloppyjuicy
Copy link

@ChristianKuehnel

@ChristianKuehnel
Copy link
Collaborator Author

@sloppyjuicy , sorry, what did you want to tell me?

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.

5 participants