[FR] Collaborative Markdown Editing

[dragotin]

OpenCloud should have collaborative editing of markdown files to offer a full blown alternative to a web office package like Collabora.

Nextcloud has that functionality on github which can act as example.

It is based on https://prosemirror.net/

Other alternative: Hedgedoc

Integration in app provider is to check.

User Stories

• As a group of people working on text documents, we want to be able to edit a markdown document collaboratively so that we can speed up our work on said document.

• As someone having write access to a markdown document in a space, I want to edit said document without creating conflicting versions, so that my colleagues don't hate me.

Value

Improve markdown editing UX. Allow working on documents together.

Acceptance Criteria

• collaboratively editing a markdown document in a space or share is possible

Definition of ready

• Everybody needs to understand the value written in the user story
• Acceptance criteria have to be defined
• All dependencies of the user story need to be identified
• Feature should be seen from an end user perspective
• Story has to be estimated
• Story points need to be less than 20

Definition of done

• Functional requirements
  • Functionality described in the user story works
  • Acceptance criteria are fulfilled
• Quality
  • Code review happened
  • CI is green (that includes new and existing automated tests)
  • Critical code received unit tests by the developer
• Non-functional requirements
  • No sonar cloud issues
• Configuration changes
  • The next branch of the OpenCloud charts is compatible

[tbsbdr]

Suitenumerique

Also worth a look:

• https://github.com/suitenumerique/docs
• https://impress-preprod.beta.numerique.gouv.fr/docs/6ee5aac4-4fb9-457d-95bf-bb56c2467713/

Slashcommands

Shalshcommands should be mandatory within the ui.

Examples:

444450700-fac4eb53-6534-449d-af18-7d18e589e43a.mp4

• https://www.youtube.com/watch?v=cBdyHp_XVFQ&t=104s

[suse-coder]

And please have it integrated into teable/nocodb (open source) https://teable.io/ or similar. As forms and sheets are everywhere it would be great if it is a real time collaboration and workflow integration tool. Where one can add the table to a markdown and it will get updated where the table was inserted.

[suse-coder]

Here is a similar idea:
nocodb/nocodb#8979

The future will be to have everything in markdown and from there call mcp or other smaller codeblocks (workflows).

[suse-coder]

https://github.com/AppFlowy-IO/appflowy is also a good reference for collaborative open source markdown editing with table support.

[suse-coder]

Plane is also open source and good markdown real time editor with even workflows: https://github.com/makeplane/plane

[lukas-scm]

I built a markdown editor web app extension with Tiptap, similar to "Nextcloud Text". You can check it out here: OpenCloud Markdown Editor

It could serve as a base for someone to integrate a y-websocket server, e.g. Hocuspocus, in the collaboration container and use the Collaboration extension

[suse-coder]

There is also https://macro.com/ (open source). which uses loro.dev (awesome crdt sync engine that is really fast for realtime edits)