Skip to content

New readme section : Requirements to build html page in virtual environments#443

Draft
antoinemeyer5 wants to merge 3 commits into
kokkos:mainfrom
antoinemeyer5:simple-build-safe-env-guide
Draft

New readme section : Requirements to build html page in virtual environments#443
antoinemeyer5 wants to merge 3 commits into
kokkos:mainfrom
antoinemeyer5:simple-build-safe-env-guide

Conversation

@antoinemeyer5
Copy link
Copy Markdown
Contributor

Simple guide for indicate:

  • how to set up from scratch a Python virtual environment locally on a machine,
  • install in that virtual environment all the requirements for the wiki build and
  • do the build in that "safe" environment

The aim is to help documentation creators to:

  • be in a controlled environment where they can be sure of using the right tools, versions, etc,
  • detect potential errors or warnings as early as possible

@antoinemeyer5 antoinemeyer5 requested a review from fnrizzi July 21, 2023 09:38
Copy link
Copy Markdown
Contributor

@ajpowelsnl ajpowelsnl left a comment

Choose a reason for hiding this comment

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

I don't have a strong opinion about this PR, other than the security caveat about using the PyCharm IDE in certain work environments. In any case, the merits of this approach vs. base install of the requirements, iterating change quickly by simply opening newly built file in a browser, are unclear. Perhaps it makes more sense if one is using an IDE ...?

Comment thread .gitignore
@@ -1,5 +1,5 @@
# Python Virtual Environment
/venv
/env
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

CAVEAT: there might be limits on using this (PyCharm) IDE in certain environments.

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