documentation icon indicating copy to clipboard operation
documentation copied to clipboard

remove section on projects?

Open alexanderdd opened this issue 2 years ago • 5 comments

Isn't the projects feature deprecated? https://help.nextcloud.com/t/lets-talk-about-projects/61326/39?u=alexanderdd

Should https://docs.nextcloud.com/server/stable/user_manual/en/files/projects.html and translations be removed?

Maybe relevant: https://github.com/nextcloud/documentation/issues/1557

alexanderdd avatar Oct 03 '23 17:10 alexanderdd

Not just yet I don't think. It was only announced as deprecated in NC25. It's still in-place. Probably need to keep it as long as the enabling knob and associated server code stays in place: nextcloud/server#33569

Though probably noting said knob and deprecated status would be good...

joshtrichards avatar Oct 16 '23 18:10 joshtrichards

Although the config knob doesn't belong in the User Manual and it being in the config.php.sample already puts it into the Admin Manual so guess that's actually covered.

It's more the question of: how to note something is deprecated in the User Manual without being too insistent about it since the Admin is really the one that decides whether making it available to their user base is acceptable (or not).

joshtrichards avatar Oct 16 '23 18:10 joshtrichards

how to note something is deprecated in the User Manual without being too insistent about it

Probably by noting this immediately within the Table of Contents, so user/admin will see:

Table of Contents

  • Projects
    • Deprecated in version 22
    • Create a Project
    • Adding more entries to a project
    • Visibility of projects

or, maybe like this:

Table of Contents

  • Projects
    • Create a Project
    • Adding more entries to a project
    • Visibility of projects
    • Status of Development

Or both. I don't remember what the version number was that deprecated projects.

sunjam avatar Nov 16 '23 12:11 sunjam

how to note something is deprecated in the User Manual without being too insistent about it

Probably by noting this immediately within the Table of Contents, so user/admin will see:

Table of Contents

* Projects
  
  * Deprecated in version 22
  * Create a Project
  * Adding more entries to a project
  * Visibility of projects

or, maybe like this:

Table of Contents

* Projects
  
  * Create a Project
  * Adding more entries to a project
  * Visibility of projects
  * Status of Development

Or both. I don't remember what the version number was that deprecated projects.

I think the first one is better, more straight-forward.

@joshtrichards said it was deprecated with NC25.

alexanderdd avatar Nov 20 '23 15:11 alexanderdd

@joshtrichards do I see correctly that it should now be safe to remove the section on projects because it was deprecated with nc25 and now the oldest supported version is nc26?

alexanderdd avatar Mar 25 '24 17:03 alexanderdd