documentation icon indicating copy to clipboard operation
documentation copied to clipboard

WIP: Working With Content as new Classic UI user guide

Open tkimnguyen opened this issue 2 years ago • 13 comments

tkimnguyen avatar Oct 07 '23 16:10 tkimnguyen

Deploy Preview for 6-docs-plone-org ready!

Name Link
Latest commit fcb23a82990df836fe7f02d546b61afaafd8d8ca
Latest deploy log https://app.netlify.com/sites/6-docs-plone-org/deploys/65297a820a1c360008d4a4fa
Deploy Preview https://deploy-preview-1547--6-docs-plone-org.netlify.app
Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

netlify[bot] avatar Oct 07 '23 16:10 netlify[bot]

I'm not really following. I wanted to help get the missing section into the docs. I was not planning on making a huge effort rewriting or rereading/verifying this content at this time. It's a work in progress. I'm not going to make 194 commits. I'm happy working on getting Volto user docs into this repository.

tkimnguyen avatar Oct 07 '23 19:10 tkimnguyen

I'm sorry I was not clear. Accuracy in documentation is the most important thing.

We do not want to publish docs in Plone 6 that have not been verified for Plone 6. It would be a disservice to visitors. We only add value to Plone 6 docs when the content has been verified for Plone 6.

Plone 5 and earlier versions of docs belong in those versions and will remain available.

stevepiercy avatar Oct 07 '23 19:10 stevepiercy

I understand. I will review the content to see how close it is to Plone 6.

tkimnguyen avatar Oct 07 '23 20:10 tkimnguyen

So far I've found stuff like:

  • links to plone.com
  • mention of Plone 5
  • mention of Internet Explorer
  • some wording that I would change

Would I need to fix things like that before you'd approve this PR?

tkimnguyen avatar Oct 09 '23 21:10 tkimnguyen

Yes. But seriously, there is no way I can review and approve 194 files in one swoop. Can you please just do one or a few pages at a time? It's OK if we do this in smaller chunks, like we're doing with all the other Plone 5 docs.

stevepiercy avatar Oct 10 '23 08:10 stevepiercy

But those 194 files are EXACTLY what was in the Plone 5 docs with the exception of a handful of screenshots I had to recreate by hand because they were missing

tkimnguyen avatar Oct 10 '23 08:10 tkimnguyen

Not only do I think you should be ok accepting those 194 files in one commit, I do not understand how to do what you're asking me to do.

tkimnguyen avatar Oct 10 '23 08:10 tkimnguyen

if anyone is spectating, Steve and I got together on Discord and came up with a plan to move forward (e.g., creating a new branch off this one into which I can make revisions, section by section, and make smaller PRs into this branch that he can review)

tkimnguyen avatar Oct 15 '23 12:10 tkimnguyen

"cage match"

tkimnguyen avatar Oct 15 '23 12:10 tkimnguyen

"cage match"

It is so on!

image

stevepiercy avatar Oct 15 '23 15:10 stevepiercy

If 2 Plonistas meet in a cage but no one is there to watch, does it make a sound?

davisagli avatar Oct 15 '23 15:10 davisagli

"It is a tale told by ~an~ idiot[s], full of sound and fury, signifying nothing" – https://www.enotes.com/topics/macbeth/questions/macbeth-says-it-is-a-tale-told-by-an-idiot-full-42403

tkimnguyen avatar Nov 05 '23 15:11 tkimnguyen