opened
JensHaley
username_0
Finished: Installation of CC and some security steps

(First tutorial for planned tutorial group for CF <-> OP scenario with cloud connector)
Install the Cloud Connector in your System Landscape
issue
created
jonathanbaker7
username_1
I have a number of notes, so I'll bullet them according to the step they are in:

**Step 1**
- The second sentence should be the start of a paragraph.  ("You need...")
- The sentence that starts "Since the Cloud Connnector..." should also start a paragraph.
- The section that says "Let's check first what Java version you have" is Windows specific, although the rest of your tutorial is multi-platform.  We don't want to have a "platform" bias, so your request should either say "bring up a command prompt" (and you can make a suggestion on windows).  
- The word **Java** should be lower case 
- Attaching a picture of the expected output would be great here
- "Step 3" isn't a step.  It's a response to not finding the software.  You should label that and take out the number
- Step 4 has the same problem as Step 3.

**Step 2**
This step looks much better.  It's clear, and the matrix makes sense.  The validate also makes sense.

**Step 3**
- Again, we shouldn't be specifying any particular platform.  The user can install  on Mac, Windows, or LInux (and you have already explained that only 2 of those are production ready.)  Help the user find the correct version for their OS.
- "Choose Run" - this is browser specific, and you don't say "use this specific browser".  Since you are using IE here, which only works on Windows, this could create confusion.  Can you choose something more browser agnostic?
- Step 4 & 5 -  Windows specific.  These should be in a note saying "if you are running Windows, you will see this..."
- Step 12 - same OS problem

**Step 4**
- Step 2 shows an IE screen.  That's OK, but you should label it as IE (and say "this might look different on your browser")  
The rest looks good - I like the screen shots...

**Step 5**
This is pretty confusing.  The idea of generating a certificate is covered, but it doesn't do so clearly (perhaps because the entire concept could require another entire page of explanation).  Is there a web site you could refer to that discusses this problem in more detail?  It should probably say something like "This is a problem for your web admin team, please consult them for details on how to do this".

Also, this step seems optional.  If the user doesn't have a certificate, and would need several days to get one, should they do that and then come back to Step 5?  This should be explained, or the step should be labeled as "optional" and describe the process that the user would do later.

**Step 6**
Set up a service?  Again, if you aren't running Windows, this is optional.  In a Linux environment, this would be an entirely different process.

---
My thought is this:  This tutorial is very Windows specific, but then leaves any other OS "in the cold".  Is that the intention?  Could you make it OS agnostic?  And, for a browser, could you use Chrome (which can be installed on every OS, including windows, mac, and linux?)
comment
created
jonathanbaker7
username_1
All changes approved, I'm OK with publishing.
comment