Content
View differences
Updated by Eric Schubert 5 days ago
**Problem:**
**An XWiki instance can have multiple wikis.**
Should we care and let the admin activate single wikis on projects. Or we ignore that and the user always sees the wikis they have access to.
**Option 1: Explicit wiki selection**
* Clarity for users not to accidentally link wiki pages others do not have access to.
* Enforced In-/Exclude wikis for projects.
**Option 2: Access to all visible wikis**
* It's clear that permissions are set on XWiki and respected
* Less setup work for project admins
* More freedom for users
UPDATED - NEW PROPOSAL
```markdown
### Proposal Wiki Integration
This is a updated proposal, due to the fact, that the initial concept was highly
criticised for not giving a good user experience. Bear in mind, that I try to redefine
the whole understanding of what this integration means.
#### Big picture
- An XWiki instance can be configured as a wiki provider.
- As a wiki provider it defines an authentication strategy and endpoints for accessing wiki content
- Wiki content consists of:
- Several wikis
- within those we have wiki pages
- Meta data on wikis and pages like linked work packages or projects
- Internal wikis will get adapters to adapt to the new structure
- the OpenProject instance will be the wiki provider
- every project CAN create a wiki
- user access is defined by project member management
#### What an admin does
- An admin needs to setup an XWiki provider
- authentication strategy
- host URL
- identifier/name
- An admin also allows to create internal wikis from projects
#### What a user can do
A user can ...
- search within ALL visible wikis (user scoped) for pages she wants to link
- add those page links to work packages (and maybe later projects) as related wiki pages
- inline those page links into rich text areas and gets prettified wiki page links from it
- create a page in every visible wiki and add the resulting wiki page link
- see all page links in the wiki tab
- the page links should provide information about the wiki they are from
- page links added by other users in a wiki the current user is not allowed to see are replaced by a placeholder - e.g. "Page link not visible due to permissions"
```
**An XWiki instance can have multiple wikis.**
Should we care and let the admin activate single wikis on projects. Or we ignore that and the user always sees the wikis they have access to.
**Option 1: Explicit wiki selection**
* Clarity for users not to accidentally link wiki pages others do not have access to.
* Enforced In-/Exclude wikis for projects.
**Option 2: Access to all visible wikis**
* It's clear that permissions are set on XWiki and respected
* Less setup work for project admins
* More freedom for users
UPDATED - NEW PROPOSAL
```markdown
### Proposal Wiki Integration
This is a updated proposal, due to the fact, that the initial concept was highly
criticised for not giving a good user experience. Bear in mind, that I try to redefine
the whole understanding of what this integration means.
#### Big picture
- An XWiki instance can be configured as a wiki provider.
- As a wiki provider it defines an authentication strategy and endpoints for accessing wiki content
- Wiki content consists of:
- Several wikis
- within those we have wiki pages
- Meta data on wikis and pages like linked work packages or projects
- Internal wikis will get adapters to adapt to the new structure
- the OpenProject instance will be the wiki provider
- every project CAN create a wiki
- user access is defined by project member management
#### What an admin does
- An admin needs to setup an XWiki provider
- authentication strategy
- host URL
- identifier/name
- An admin also allows to create internal wikis from projects
#### What a user can do
A user can ...
- search within ALL visible wikis (user scoped) for pages she wants to link
- add those page links to work packages (and maybe later projects) as related wiki pages
- inline those page links into rich text areas and gets prettified wiki page links from it
- create a page in every visible wiki and add the resulting wiki page link
- see all page links in the wiki tab
- the page links should provide information about the wiki they are from
- page links added by other users in a wiki the current user is not allowed to see are replaced by a placeholder - e.g. "Page link not visible due to permissions"
```