Comments (2)
- Stuck the versions of the stacks in the blogposts (Express, Django...) for not being ping in few months/years that the tutorial is not working
Is the suggestion here that we add explicit notes to the blog posts that say which version was used?
- @GuGuss like the Django blogpost title (Up(sun) and running with Django) and would like all of our blogpost to have the same "wordplay" --> Up(sun) and running with ...
I leave this to the article authors if they want to match my wordplay title or not.
- In the stack dedicated section, in the note block, tell the reader that the Upsun demo app link is a call to action, as it is a link to an "external" website (the console) to create a new demo app. Otherwise, being redirected to the console login page can be confusing.
I believe we can add an icon next to the link to remove the jarring effect here.
- In the stack dedicated section, remove the first link in the Getting started section as the Upsun demo application is already mention in the note block above.
Makes sense, yeah let's remove.
- In the stack dedicated section, change title of the Documentation to Go further: Getting started is for beginner and then, documentation section is for more advanced user.
I don't understand the suggested change here.
- Framework section: is it possible to add the same menu as for the generic guide per stacks, and remove the subitem of the Configure your project section that are not language related to the stack?
example ...
We had a lot of discussion around this structure - I'd like to test for a while before adopting one of the alternatives we had thought about. In the interim, and perhaps to solve the issue here, let's generalize {{< get-started/steps >}}
so that it can be included in the Getting started section of each stack page, providing the steps same as we see here https://docs.upsun.com/get-started/here.html
- make the Framework.language section clickable with a dedicated page to the language, with a hello world example for the language.
This is a larger conversation.
from platformsh-docs.
On #2, are we planning then on removing all stack-specific guides from the documentation and migrate them to the blog? Seems odd to have the docs duplicate the blog, or the blog duplicate the docs.
On #5, this is now no longer documentation. This is a list of links, and does contain documentation on how to "Deploy Express on Upsun". IMO, if we are going to have dedicated stack sections in the documentation, then they need to include information that covers the specifics/uniqueness of a stack that isn't covered by the generic guide. Blog posts should then expand on the documentation to cover a topic that isn't included in the docs (e.g. adding a melisearch service to an express project).
If the intent of these sections is to just be a list of resources, then they should be renamed "<stack/framework> on Upsun" to indicate the page covers topics concerning the stack/framework and its operation on Upsun.
Specific to the Getting Started guide
I find the Errors on First Push section to be confusing. Given the section before it (Required Files) covers the configuration files, we have them run project:init
, and commit the configuration files, the Errors on First Push section with an error of Configuration directory '.upsun' not found.
should never occur. Even under the Console tab, the error would only occur if an integration has been used (side note, the image at this location is incorrect as well), but we've already stated at the Create Project step that Git Integrations are outside the scope of the guide and are covered later. This section should be moved from this page and into the page covering Git Integrations.
Should we give a clarification for this Warning as to why an environment might not be active? Given we have them create the branch using the Upsun cli, it will by default activate the environment (and we mention this in that section) so this seems out of place.
from platformsh-docs.
Related Issues (20)
- CLI: build resources - replace curl command in docs HOT 1
- Fix PHP "Alternate start command" code example
- Open left bar should open to current page
- Formatting repair for shortcode embedded in code blocks
- 🐛 Issue on the page Integrate with Bitbucket | Platform.sh Documentation
- Mention of limited support for DG2 in Node Versions
- redis: update service warning about disk size
- Change get support link
- New plugins for opensearch 2.0
- Add external material link to the Django doc page
- private git repositories and submodules, ssh
- private git repositories and submodules, public key
- 🐛 Clarify where settings.php files are located
- Description for Client-Abuse-Score
- Add python external link to the doc
- Update process for installing Python Poetry
- run a Runtime operation from the console
- Update docs for steps with the new organization display
- add section for grid vs dedicated
- Potentially refactor ssh keys section
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from platformsh-docs.