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

Convert Kedro principles documentation page into a blog post #32

Closed
stichbury opened this issue Feb 16, 2023 · 4 comments
Closed

Convert Kedro principles documentation page into a blog post #32

stichbury opened this issue Feb 16, 2023 · 4 comments
Assignees
Labels
Blog post creation Blog posts (ideas and execution)

Comments

@stichbury
Copy link
Contributor

stichbury commented Feb 16, 2023

The Kedro principles page is a nice enough page but doesn't really work in documentation. Let's move it out into a post or page.

Or, failing that, a topic page that sits on the website (but isn't in the nav, so you can find it organically but we don't push it to the user).

@stichbury stichbury added the Blog post creation Blog posts (ideas and execution) label Feb 16, 2023
@stichbury
Copy link
Contributor Author

@astrojuanlu Do you have any thoughts on this one? I was thinking about maybe moving the principles page to make it a markdown piece of content in the Kedro project, rather than a page of documentation, and then later rewriting it as a blog post. Just trying to have a "spring clean" and remove some of the less useful pieces of content that lurk at the bottom of the table of contents.

@astrojuanlu
Copy link
Member

astrojuanlu commented Feb 27, 2023

@stichbury Similarly to kedro-org/kedro#2368, what do you think of having these as dev docs? They function as "guiding principles" - I agree they're only anecdotically interesting for users, but much more for developers. And it doesn't harm turning them into a blog post as well. In either case, I agree with removing them from the user docs.

@stichbury
Copy link
Contributor Author

Just as a matter of interest, the Principles page doesn't show up on Heap as having any large number of page views in a year (it's lower than any of those reported, so is getting less than 1700 views per year)

@stichbury stichbury moved this to To Do in Kedro Framework Apr 17, 2023
@stichbury stichbury moved this from To Do to In Progress in Kedro Framework Apr 18, 2023
@stichbury stichbury moved this from In Progress to In Review in Kedro Framework Apr 18, 2023
@stichbury stichbury moved this from In Review to To Do in Kedro Framework Apr 19, 2023
@stichbury stichbury moved this from To Do to In Progress in Kedro Framework Apr 24, 2023
@stichbury stichbury moved this from In Progress to In Review in Kedro Framework Apr 24, 2023
@yetudada yetudada moved this from In Review to Done in Kedro Framework Apr 25, 2023
@stichbury
Copy link
Contributor Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Blog post creation Blog posts (ideas and execution)
Projects
Archived in project
Development

No branches or pull requests

2 participants