Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

need to synch installation instructions #254

Closed
tkimnguyen opened this issue Mar 20, 2017 · 9 comments
Closed

need to synch installation instructions #254

tkimnguyen opened this issue Mar 20, 2017 · 9 comments

Comments

@tkimnguyen
Copy link
Member

https://training.plone.org/5/mastering_plone/installation.html needs to match docs.plone.org and plone.org/download as per plone/documentation#807 plone/ploneorg.core#208 and https://github.com/plone/simple-plone-buildout/

@tkimnguyen
Copy link
Member Author

e.g. in https://training.plone.org/5/mastering_plone/installation.html we do not actually have a VirtualBox appliance on https://plone.org/download

@tkimnguyen
Copy link
Member Author

Need to ensure all hosting info is still valid, e.g. link to a Codio.com blog post by @pigeonflight [http://blog.dbain.com/2014/04/install-plone-in-under-5-minutes-on.html]

@tkimnguyen
Copy link
Member Author

In fact a lot of this info here is better than what we have on plone.org and docs.plone.org :)

@gforcada
Copy link
Member

Let's all point here then. In fact, the training docs are probably the ones that at least once a year are really taken care of to be up-to-date...

@tkimnguyen
Copy link
Member Author

tkimnguyen commented Mar 20, 2017

IMO install docs should defer to what the installers each say. e.g. unified installer will do more handling of requirements so less to do for users, so we should not overburden users with extra info they will never need to know. On the https://plone.org/download page yesterday I adjusted it to have some generic text and a link to https://docs.plone.org but I'm rethinking that.

System Requirements

Plone runs on a wide range of hardware, from RaspberryPi to Chromebooks, PCs and Macs, servers, and cloud deployments on Amazon EC2, Linode, Rackspace and more.

Plone runs on most UNIX-based distributions (including Linux, BSD, Solaris, and other proprietary UNIX systems), on Windows and Mac OS.

See Plone's (full hosting, operating system, and hardware requirements)[https://docs.plone.org/manage/installing/requirements.html].```

@tkimnguyen
Copy link
Member Author

As in #287 I think it would be easiest to keep all installation / evaluation options on plone.org/download where we can, in fact, make very quick changes in just that one place.

@stevepiercy
Copy link
Contributor

To clarify, I think that listing the options on plone.org/download is appropriate. However detailed instructions of how to install Plone should be at https://docs.plone.org/manage/index.html.

Unfortunately the installation for Plone 6 is spread across several Trainings as well as on https://docs.voltocms.com/ and does not yet exist on docs.plone.org.

@stevepiercy
Copy link
Contributor

I created an issue for docs.plone.org in plone/documentation#1134

@stevepiercy
Copy link
Contributor

@tkimnguyen are there any actionable items for this issue that are not covered elsewhere, or can this issue be closed? I think #577 covers what can be done in the Training docs at this time. Everything else is external or it was valid for each training at the time.

Trainings for Plone 5 will not be updated. IMO the training's authors should update their training, else we archive it for Plone 5 trainings and exclude it from toctrees in Sphinx — not delete it — for publication in Plone 6 trainings.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants