Migrate backing up Plone docs

[Manas-Kenge]

Issue number

• Ref Purge empty pages and todos #1882

Description

• https://6.docs.plone.org/backend/upgrading/preparations.html#back-up-your-plone-site

---

📚 Documentation preview 📚: https://plone6--1919.org.readthedocs.build/

[stevepiercy]

Please follow Plone documentation styleguide, especially the one sentence per line guideline.

[Manas-Kenge]

@stevepiercy can you review this PR? I tried my best to follow Plone documentation styleguide, but I might have missed a few things. Thank you!

[rohnsha0]

I am not in favor of listing collective.recipe.backup here as its only tested and compatible (as per info on docs) upto PY3.9 and is not maintained actively anymore.
and recommended PY versions for Plone 6 are >=3.10

ps: still I will test it and update! thanks!

[stevepiercy]

@Manas-Kenge you haven't responded to my earlier comment:

especially the one sentence per line guideline.

[Manas-Kenge]

Sorry for the late reply @stevepiercy, I was busy.

[stevepiercy]

The original content needed a thorough edit job. Conceptual guide or explanation material does not belong in a how-to guide, such as this one. Even now, it may have too much explanation, but we don't have such a conceptual guide to refer to. Ideally, we'd have a thorough entry in the Admin guide.

I am not in favor of listing collective.recipe.backup here as its only tested and compatible (as per info on docs) upto PY3.9 and is not maintained actively anymore.

@rohnsha0 where did you get that information? See https://github.com/collective/collective.recipe.backup/blob/master/CHANGES.rst.

Anyway, I'm OK with this PR now, except I want a technical review from someone else.

[stevepiercy]

@plone/classicui-team can I get a technical review from y'all?

[davisagli]

These docs are only valid for a Plone site that was installed using buildout. I'd suggest putting it in its own chapter ("How to back up and restore a Plone buildout") and then link to that from the upgrade guide, with a clear note about when it's applicable.

[stevepiercy]

@davisagli thanks for the context.

@Manas-Kenge would you please perform the following:

• Move the content from lines 55-130 into its own page, entitled "Back up and restore a Plone buildout", located at docs/admin-guide/backup-restore-plone-buildout.md, as suggested by @davisagli?

• Use an existing page in docs/admin-guide/ as a template to add its html meta attributes.

• Add a toctree entry in docs/admin-guide/index.md for the new page.

• In its former location, add a seealso.

  ```{seealso}
  For a Plone site installed via buildout, follow {doc}`/admin-guide/backup-restore-plone-buildout` for details.
  ```
  

Thank you!

[stevepiercy]

Minor tweak, then I'll merge. Thank you!