Refs #6272: update Javascript developer guide post Bastion.

[waldenraines]

No description provided.

[daviddavis]

FYI, there are some things we need to do with this file (not sure if you'd be interested in doing this in this PR):

1. Need to fix code highlighting. See Fixes #6579 - Fixing code blocks in our documentation #21
2. We need to fix the file extension (should be md and not mkd)

[waldenraines]

Need to fix code highlighting. See #21

#21 (comment)

We need to fix the file extension (should be md and not mkd)

Done.

[ehelms]

@waldenraines do you think we should break out the JS docs into these different sections or silo it all under a Bastion heading?

[waldenraines]

@ehelms what do you mean by "these different sections" and by "silo it all..." do you mean put a Bastion header up top or otherwise specify that this applies to Bastion only?

[ehelms]

@waldenraines and/or create a section that houses all the Bastion specific documentation?

[waldenraines]

@ehelms so move all of the bastion documentation here from https://github.com/katello/katello/tree/master/engines/bastion ?

[ehelms]

@waldenraines sort of two questions:

1. Should we just move all the Bastion documentation to these docs?
2. How should we organize those documents? One file? A section with subsections?

[waldenraines]

1. Should we just move all the Bastion documentation to these docs?

We could, I'm good with that, at least that way they will be centralized.

2. How should we organize those documents? One file? A section with subsections?

I think we should split them up because it is a wall of text.

[waldenraines]

@ehelms updated.

[ehelms]

Hrmm, the docs for these pages don't lay themselves out very logically. What about making a top level nav section for Bastion for now? And making the 'The Katello UI Engine' page essentially the index/first page?

[waldenraines]

@ehelms updated.

[ehelms]

I am seeing:

[waldenraines]

@ehelms updated.

[ehelms]

Hrmm, I am getting

      Generating...   Liquid Exception: Included file '/home/ehelms/workspace/katello.org/_includes/sidebars/bastion.html' not found in _includes/{{page.sidebar}}, included in _layouts/base.html

[waldenraines]

@ehelms guess it would help if I git add that file. Updated.

[ehelms]

ACK