Comments (7)
I laid out my ideas for how to solve this issue in #29 , let me know what you think.
from guide-kubernetes-intro.
Tagging @cajaygle @megmulsy @lauracowen if they have thoughts. @kinueng @mbroz2 @gcharters @NottyCode, FYI and your feedback welcome too.
The team will work out options given what we have and share them ASAP.
from guide-kubernetes-intro.
I think #29 (comment) is suggesting we have a single code block with selectable tabs on top. The tabs would be labeled as "Windows, Unix, ..." and a reader can click one of the tabs to show the platform specific command.
If we want a code block with tabs, we will need to write an Asciidoc extension to support tabs since Asciidoc does not have native tabs support.
from guide-kubernetes-intro.
@kinueng, that is an idea or an option. We don't have a decision on that yet and I will suggest for @cajaygle and @megmulsy to consider what will be the appropriate design for this using the Kube and Istio guides as the basis.
In the mean time, we are moving forward to try to wrap the Kube and Istio guides with what we have today -- with Asciidoc as-is; granted they must be consumable -- and any visual or design improvements can come later (as part of multi-pane layout).
There is other design issue to consider for these 2 guides too: There isn't too many code snippets or classes in them. So, in a multi-pane layout, we pretty much have a unused pane.
from guide-kubernetes-intro.
I also feel that having a single box with the platform-appropriate command would be the best. we can auto-detect their platform, and at the beginning of the guide or first appearance of a platform-specific command we tell them we've auto-detected their platform and give them the option to change it. then all subsequent instructions would use that platform to display the appropriate command. if we did that then maybe we wouldn't need a selection mechanism for each command block, or that may still be useful to include on each.
from guide-kubernetes-intro.
One thing to keep in mind is that it may not be only the commands that change. You may want slightly different instructions as well. For example, in this guide we need to run minikube start
for one platform, and for another platform we tell them to go to their settings and check a box. We could probably write them in a way such that only the commands change, but it would be more flexible to take into account that some instructions may change as well.
from guide-kubernetes-intro.
I think we're done with this issue with the current guide(s).
from guide-kubernetes-intro.
Related Issues (20)
- Daily build test issues HOT 4
- One of the labels not highlighted HOT 2
- Guide needs an update to use new hotspot labelling HOT 2
- Dev mode peer review HOT 5
- dev mode peer review - macOS HOT 3
- Investigate to use latest version of minikube for linux HOT 2
- Cloud-hosted - ports already allocated HOT 1
- Cloud-hosted - unable to access the services directly HOT 1
- Is something missing from the section: "Next you will make requests to your services." HOT 7
- Error after updating the images names and nodePorts HOT 2
- Develop Cloud Native apps on OpenShift with Open Liberty HOT 2
- Failed to Inject @ConfigProperty for key SYS_APP_HOSTNAME HOT 3
- Enable issues and PR creation notification on the repo HOT 1
- Need to rework the automated script to run candidate build test HOT 1
- Consider a way to report build version in tests HOT 1
- multipane HOT 3
- The test script isn't working on MacOS HOT 2
- Travis test with openjdk11 isn't launched for kube-intro guide HOT 1
- Multipane Issues HOT 3
- Multipane - Post-publish test HOT 2
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 guide-kubernetes-intro.