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

complete readme redesign #7530

Merged
merged 34 commits into from
Sep 29, 2020
Merged

complete readme redesign #7530

merged 34 commits into from
Sep 29, 2020

Conversation

vitormmatos
Copy link
Contributor

updated deno description matching the official site.

deno logo added aligned to the right side of the description.

twitter badge added.

installation, getting started and contributing sections have been added

readme-update-screenshot

ry and others added 9 commits September 16, 2020 12:41
This reverts the changes introduced by PR denoland#5276, which made
`deno install «script»` automatically bundle the script's dependencies.
It broke the `deno install` command for a large number of scripts.

This reverts commit 34e98fa.

Closes: denoland#7492
Also re-exports deno_core::futures and deno_core::serde_json but these are not yet used in the CLI.
)

Instead use Deno.core.jsonOpSync and Deno.core.jsonOpAsync
updated deno description matching the official site.

deno logo added aligned to the right side of the description.

twitter badge added.

installation, getting started and contributing sections have been added
updated deno description matching the official site.

deno logo added aligned to the right side of the description.

twitter badge added.

installation, getting started and contributing sections have been added
@CLAassistant
Copy link

CLAassistant commented Sep 17, 2020

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
10 out of 11 committers have signed the CLA.

✅ piscisaureus
✅ ry
✅ bartlomieju
✅ caspervonb
✅ nayeemrmn
✅ g-plane
✅ JayHelton
✅ lucacasonato
✅ tokiedokie
✅ vitormmatos
❌ Vitor Matos


Vitor Matos seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

@kitsonk
Copy link
Contributor

kitsonk commented Sep 17, 2020

It is probably a really good idea to discuss these sorts of changes with someone on the core team before you attempt to raise a PR.

@ry
Copy link
Member

ry commented Sep 17, 2020

@kitsonk is right - but in this case I like it! Please sign the CLA and I'll land.


You can find a more in depth introduction, examples, and environment setup guides in the [manual](https://deno.land/manual).

More in-depth info can be found in the runtime [documentation](doc.deno.land)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
More in-depth info can be found in the runtime [documentation](doc.deno.land)
More in-depth info can be found in the [runtime documentation](https://doc.deno.land/builtin/stable)

Copy link
Contributor

Choose a reason for hiding this comment

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

missing url

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
More in-depth info can be found in the runtime [documentation](doc.deno.land)
More info can be found in the [runtime documentation](https://doc.deno.land/builtin/stable).

README.md Outdated

We appreciate your help!

To contribute, please read the our [guidelines](https://github.com/denoland/deno/blob/master/docs/contributing/style_guide.md)
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
To contribute, please read the our [guidelines](https://github.com/denoland/deno/blob/master/docs/contributing/style_guide.md)
To contribute, please read the our [guidelines](https://deno.land/manual/contributing)

Copy link
Contributor

Choose a reason for hiding this comment

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

I think we should use deno.land/manual instead of a markdown file

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
To contribute, please read the our [guidelines](https://github.com/denoland/deno/blob/master/docs/contributing/style_guide.md)
To contribute, please read our [guidelines](https://deno.land/manual/contributing).


See [deno_install](https://github.com/denoland/deno_install/blob/master/README.md) and [releases](https://github.com/denoland/deno/releases) for other options.

### Getting Started
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### Getting Started
## Getting Started


[Install](https://github.com/denoland/deno_install)
### Install
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### Install
## Install


[Website](https://deno.land/)
### Features
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
### Features
## Features

README.md Outdated
- Supports TypeScript out of the box.
- Ships only a single executable file.
- Built-in utilities like a dependency inspector (deno info) and a code formatter (deno fmt).
- Set of reviewed standard modules that are guaranteed to work with [Deno](https://deno.land/std/)
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
- Set of reviewed standard modules that are guaranteed to work with [Deno](https://deno.land/std/)
- Set of reviewed standard modules that are guaranteed to work with [Deno](https://deno.land/std/).

@vitormmatos
Copy link
Contributor Author

@kitsonk is right - but in this case I like it! Please sign the CLA and I'll land.

Just signed the CLA.
I know it's not much, but I hope I can help the project, now and in the future.
About discussing with the core team for future pull requests, where can it be done?

Thanks for the support.

@kitsonk
Copy link
Contributor

kitsonk commented Sep 17, 2020

@vitormmatos two main ways, an issue stating what the problem is and the suggested approach to fix it, second would be on Discord in the #dev channel there.

@newtack
Copy link

newtack commented Sep 17, 2020

Not sure this is the right place, but I would make the following change:

Batteries included:

  • Tooling: built-in Typescript compiling, testing, linting and formatting.
  • Standard libraries replacing need for many 3rd party libraries

For me personally, another huge value add is that with the single executable I can upgrade the equivalent of Node, Typescript, eslint, jest, prettier in one command and all integrated.

Deno really removes a lot of friction.


Or a more complex one:

```sh
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this sh should be js.

@ry
Copy link
Member

ry commented Sep 18, 2020

@vitormmatos can you please check the CLA again - it's not green.

@Skillz4Killz
Copy link

If Twitter is added perhaps Discord could be added? 🤔

[![Discord](https://img.shields.io/discord/684898665143206084?color=697EC4&label=Discord&logo=discord&logoColor=FDFEFE&style=flat-square)](https://discord.gg/deno) You may need to enable the widget in discord server settings

@vitormmatos
Copy link
Contributor Author

@vitormmatos can you please check the CLA again - it's not green.

Not sure what happened before, It was showing that I was signed in the CLA.
I tried it again just now and it's showing as signed.

Screen Shot 2020-09-20 at 22 37 18

@kitsonk
Copy link
Contributor

kitsonk commented Sep 21, 2020

@vitormmatos the e-mail you used in the commit message does not match what you have registered on your GitHub account, and therefore it cannot identify you as the author of the commit:

commit 9e7966741d9a18a90dba62f8f58aac7bf5f8b105
Author: Vitor Matos <[email protected]>
Date:   Wed Sep 16 21:40:53 2020 -0300

    complete readme redesign
    
    updated deno description matching the official site.
    
    deno logo added aligned to the right side of the description.
    
    twitter badge added.
    
    installation, getting started and contributing sections have been added

There are ways to hide your e-mail address with GitHub, under your profile settings, if you don't want it to be part of a commit message. GitHub will issue you a specific GitHub e-mail address tied to your account.

@vitormmatos
Copy link
Contributor Author

@vitormmatos the e-mail you used in the commit message does not match what you have registered on your GitHub account, and therefore it cannot identify you as the author of the commit:

commit 9e7966741d9a18a90dba62f8f58aac7bf5f8b105
Author: Vitor Matos <[email protected]>
Date:   Wed Sep 16 21:40:53 2020 -0300

    complete readme redesign
    
    updated deno description matching the official site.
    
    deno logo added aligned to the right side of the description.
    
    twitter badge added.
    
    installation, getting started and contributing sections have been added

There are ways to hide your e-mail address with GitHub, under your profile settings, if you don't want it to be part of a commit message. GitHub will issue you a specific GitHub e-mail address tied to your account.

I have no problem with the e-mail been shown, but how can I fix it now?
I've changed the e-mail used on global config on my machine to match the one used on Github, what shall I do next for the CLA license to be properly signed. Should I do a new commit?

Sorry for the trouble.

@vitormmatos
Copy link
Contributor Author

Just now I realized something quite strange. I'm signed and not signed in the CLA. My username is vitormmatos. Sorry for the trouble guys, really. Honestly, I have no idea what's going on here, and how to fix this.
Screen Shot 2020-09-21 at 04 20 29

@hazae41
Copy link
Contributor

hazae41 commented Sep 29, 2020

@vitormmatos I think you have to make a whole new branch, new commit and new PR

Copy link
Member

@ry ry left a comment

Choose a reason for hiding this comment

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

LGTM - thanks @vitormmatos

@ry ry merged commit 04f05d0 into denoland:master Sep 29, 2020
Soremwar pushed a commit to Soremwar/deno that referenced this pull request Oct 6, 2020
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.