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

Configuring the System is empty #2987

Open
oleg-nenashev opened this issue Mar 19, 2020 · 4 comments
Open

Configuring the System is empty #2987

oleg-nenashev opened this issue Mar 19, 2020 · 4 comments
Labels
bug documentation Jenkins documentation, including user and developer docs, solution pages, etc.

Comments

@oleg-nenashev
Copy link
Contributor

Problem with: Configuring the System, source file

The page is empty, and I am not sure what is supposed to be there. My suggestion would be to just cleanup the page. CC @MarkEWaite

@oleg-nenashev oleg-nenashev added bug documentation Jenkins documentation, including user and developer docs, solution pages, etc. labels Mar 19, 2020
@MarkEWaite
Copy link
Contributor

MarkEWaite commented Jul 20, 2020

Discussed in the Docs office hours and recommended that the page be retained and used as an introduction to the alternatives available to a user to configure Jenkins. A few introductory paragraphs that might introduce:

  • Jenkins can be configured at many levels and with many different techniques

  • Configuration layers might include

    • Jenkins master configuration
    • Jenkins agent configuration (link to node configuration)
    • Jenkins security configuration (link to authorization and authentication)
  • Configuration pages are frequently created and extended by plugins

  • Configuration techniques might include:

    • Configuration from the UI
    • Configuration from system level groovy scripts
    • Configuration from REST API calls
    • Configuration from Jenkins command line interface (CLI)
    • Configuration as code plugin
    • Job DSL plugin to define job configurations

@getJv
Copy link
Contributor

getJv commented Jul 25, 2020

I'm working on it. ;)

@daniel-beck
Copy link
Contributor

Discussed in the Docs office hours and recommended that the page be retained and used as an introduction to the alternatives available to a user to configure Jenkins

From context (neighboring pages that weren't recently added), it looks like this chapter is structured like the "Manage Jenkins" page, and discusses each entry there in its own subsection: Configure Tools, Configure Security (until yesterday), Manage Plugins, the Jenkins CLI, Managing Nodes, etc.

So your plan is probably useful, but goes against the established structure of the chapter.

Or it's time to completely abandon the previous approach, newly added pages basically don't adhere to this structure anyway.

@Vandit1604
Copy link
Contributor

Hey I would like to work on this if no one is working on this

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug documentation Jenkins documentation, including user and developer docs, solution pages, etc.
Projects
None yet
Development

No branches or pull requests

5 participants