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

[WIP] Review Docs in light of config changes #175

Closed
wants to merge 11 commits into from

Conversation

wxtim
Copy link
Member

@wxtim wxtim commented Dec 2, 2020

I've added suggestion comments in places where I see the possibility of making changes which I believe may spark debate.

Pre-requisites:

@wxtim wxtim self-assigned this Dec 2, 2020
@wxtim wxtim marked this pull request as draft December 2, 2020 12:34
@wxtim
Copy link
Member Author

wxtim commented Dec 2, 2020

@dpmatthews @oliver-sanders @hjoliver - this PR is still in draft form, but I'm tagging you so that you can see I'm having a good look at this stuff.

It's by no means finished atm.

A Cylc suite is a directory containing a :cylc:conf:`flow.cylc` file
workflow
Cylc workflow
A Cylc workflow is a directory containing a :cylc:conf:`flow.cylc` file
Copy link
Member Author

@wxtim wxtim Dec 2, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't really what a workflow is, but how it's defined.

Suggested change
A Cylc workflow is a directory containing a :cylc:conf:`flow.cylc` file
A Cylc workflow is a way of organizing one or more programs, specifying relationships between them. Is is defined in a directory containing a :cylc:conf:`flow.cylc` file.

Comment on lines +13 to 15
The workflow directory contains all of the configuration for a workflow e.g.
the :cylc:conf:`flow.cylc` file.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The workflow directory contains all of the configuration for a workflow e.g.
the :cylc:conf:`flow.cylc` file.
The workflow directory contains all of the configuration for a workflow.
In its most basic form the workflow directory will contain a :cylc:conf:`flow.cylc` file.

@wxtim wxtim closed this Dec 2, 2020
@hjoliver
Copy link
Member

hjoliver commented Dec 3, 2020

Did you intend to close this @wxtim ?

@wxtim
Copy link
Member Author

wxtim commented Dec 3, 2020

Did you intend to close this @wxtim ?

Yep. It suffered massive mission creep

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants