Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Get Started Walkthrough for vscode knative #276

Merged
merged 3 commits into from
Oct 10, 2022

Conversation

sudhirverma
Copy link
Contributor

Fix: #262

@codecov-commenter
Copy link

codecov-commenter commented Aug 4, 2022

Codecov Report

Merging #276 (b46b2d5) into main (01c64f6) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #276   +/-   ##
=======================================
  Coverage   77.19%   77.19%           
=======================================
  Files          87       87           
  Lines        3561     3561           
  Branches      604      604           
=======================================
  Hits         2749     2749           
  Misses        812      812           

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

@sudhirverma sudhirverma changed the title Get Started Walkthrough for vscode knative [WIP] Get Started Walkthrough for vscode knative Aug 4, 2022
Copy link
Contributor

@lstocchi lstocchi left a comment

Choose a reason for hiding this comment

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

By a quick glance it looks good. I would change something in the descriptions but i'll leave the english review to Mohit as i suck.
Only 3 notes:

  1. maybe it's better to add an action in the create new function step that opens up the wizard to create a func. In IJ i cannot do it as the plugin works with all Jetbrains IDEs (IJ, GoLand, Pycharm,...) and they work differently but in vscode i guess it should be easier.
  2. Is it really necessary to have the add/remove env variable/volumes explained?
  3. in the invoke step i would mention the function need to be run before to invoke it.

@sudhirverma
Copy link
Contributor Author

2. Is it really necessary to have the add/remove env variable/volumes explained?

@mohitsuman should we include the add/remove env variable/volumes in getting started or should I skip it?

package.json Outdated
"walkthroughs": [
{
"id": "knativeWalkthrough",
"title": "Getting started with Knative",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"title": "Getting started with Knative",
"title": "Getting Started with Knative and Serverless Functions",

package.json Outdated
{
"id": "knativeWalkthrough",
"title": "Getting started with Knative",
"description": "Start managing serverless applications on OpenShift and Kubernetes",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "Start managing serverless applications on OpenShift and Kubernetes",
"description": "Develop & Deploy Serverless Functions using VSCode",

package.json Outdated
"steps": [
{
"id": "Create Function",
"title": "Create a new function project",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"title": "Create a new function project",
"title": "Create Function",

package.json Outdated
{
"id": "Create Function",
"title": "Create a new function project",
"description": "To create a new function click on \"plus icon(Create Function)\" in Functions view title.\n By providing Name, selecting language eg:(go, node, python, quarkus, rust, springboot and typescript), selecting template eg:(http or cloudevents), selecting location, and click on create function. The new function is now visible in the Function tree view.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "To create a new function click on \"plus icon(Create Function)\" in Functions view title.\n By providing Name, selecting language eg:(go, node, python, quarkus, rust, springboot and typescript), selecting template eg:(http or cloudevents), selecting location, and click on create function. The new function is now visible in the Function tree view.",
"description": "Creates a Function in the mentioned directory with the specified language/runtime selected and handles HTTP events.",

Copy link
Collaborator

Choose a reason for hiding this comment

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

Also add a Button to Create Component below the description. This will directly open the webview to select the workflow.

package.json Outdated
},
{
"id": "Build Function",
"title": "Build function",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"title": "Build function",
"title": "Build Function",

package.json Outdated
{
"id": "Invoke Function",
"title": "Invoke a Function",
"description": "Invokes the Function by sending a request to the current running Function instance, either locally or remote.\nOnly a function which has the source code opened in the IDE can be invoked. Right click on the function you want to invoke (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Invoke\". Provide all necessary details and click on invoke.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "Invokes the Function by sending a request to the current running Function instance, either locally or remote.\nOnly a function which has the source code opened in the IDE can be invoked. Right click on the function you want to invoke (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Invoke\". Provide all necessary details and click on invoke.",
"description": "Invokes the function by sending a test request to the currently running function instance, either locally or remote.\nOnly a function which has the source code opened in the IDE can be invoked. Right-click on the function you want to invoke (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Invoke\". Provide all necessary details and click on Invoke.",

package.json Outdated
{
"id": "Add environment variable",
"title": "Add environment variable to the function configuration",
"description": "Only a function which has the source code opened in the IDE can be configure to add environment variables.\n Right click on the function you want to add environment variables (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Add Config\" and then click on \"Add Environment Variables\". An Interactive prompt will open in terminal to add Environment variables.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "Only a function which has the source code opened in the IDE can be configure to add environment variables.\n Right click on the function you want to add environment variables (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Add Config\" and then click on \"Add Environment Variables\". An Interactive prompt will open in terminal to add Environment variables.",
"description": "Only a function which has the source code opened in the IDE can be configured to add environment variables.\n Right-click on the function you want to add environment variables (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \" Add Config\" and then click on \" Add Environment Variables\". An Interactive prompt will open in the terminal to add Environment variables.",

package.json Outdated
{
"id": "Add volumes",
"title": "Add volume to the function configuration.",
"description": "Only a function which has the source code opened in the IDE can be configure to add volumes.\n Right click on the function you want to add volume (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Add Config\" and then click on \"Add volumes\". An Interactive prompt will open in terminal to add Secrets and ConfigMaps as Volume.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "Only a function which has the source code opened in the IDE can be configure to add volumes.\n Right click on the function you want to add volume (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Add Config\" and then click on \"Add volumes\". An Interactive prompt will open in terminal to add Secrets and ConfigMaps as Volume.",
"description": "Only a function which has the source code opened in the IDE can be configured to add volumes.\n Right-click on the function you want to add volume (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \" Add Config\" and then click on \" Add volumes\". An Interactive prompt will open in the terminal to add Secrets and ConfigMaps as Volume.",

package.json Outdated
{
"id": "Remove environment variable",
"title": "Remove environment variable from the function configuration",
"description": "Only a function which has the source code opened in the IDE can be configure to remove environment variables.\n Right click on the function you want to remove environment variables (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Remove Config\" and then click on \"Remove Environment Variables\". An Interactive prompt will open in terminal to remove environment variables.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "Only a function which has the source code opened in the IDE can be configure to remove environment variables.\n Right click on the function you want to remove environment variables (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Remove Config\" and then click on \"Remove Environment Variables\". An Interactive prompt will open in terminal to remove environment variables.",
"description": "Only a function which has the source code opened in the IDE can be configured to remove environment variables.\n Right-click on the function you want to remove environment variables (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Remove Config\" and then click on \"Remove Environment Variables\". An Interactive prompt will open in the terminal to remove environment variables.",

package.json Outdated
{
"id": "Remove volumes",
"title": "Remove volume from the function configuration",
"description": "Only a function which has the source code opened in the IDE can be configure to remove volumes.\n Right click on the function you want to remove volume (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Remove Config\" and then click on \"Remove volumes\". An Interactive prompt will open in terminal to remove volume mounts from the function.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
"description": "Only a function which has the source code opened in the IDE can be configure to remove volumes.\n Right click on the function you want to remove volume (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Remove Config\" and then click on \"Remove volumes\". An Interactive prompt will open in terminal to remove volume mounts from the function.",
"description": "Only a function which has the source code opened in the IDE can be configured to remove volumes.\n Right-click on the function you want to remove volume (look for its node in the Functions tree), open the context menu (right-click on the node) and click on \"Remove Config\" and then click on \"Remove volumes\". An Interactive prompt will open in the terminal to remove volume mounts from the function.",

@mohitsuman mohitsuman merged commit 9e06c3a into redhat-developer:main Oct 10, 2022
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Get Started Walkthrough for vscode knative
4 participants