Merge pull request #29 from mercadopago/feature/readme

Feature/readme

CHANGELOG.md

@@ -0,0 +1 @@
+## VERSION 1.0.0

CONTRIBUTING.md

@@ -0,0 +1,83 @@
+
+# Coding Guidelines
+
+The Mercado Pago Go SDK is a collaborative effort from the start. The SDK team believes that contributions from different developers will enrich its feature set and make it more relevant to the community.
+
+However, absorbing all contributions as-is, while expedient, might lead to difficulties in maintaining the codebase if left unchecked. A collaborative codebase often establishes guidelines for contributors to ensure that the code remains maintainable over time. The effort to maintain the SDK is no different in this regard, so a bit of guidance is in order.
+
+The purpose of this guide is to set a baseline for contributions. These guidelines are not intended to limit the tools at your disposal or rewire the way you think but rather to encourage good neighbor behavior.
+
+## Language Guidelines
+
+We use **English** language. This is to be consistent everywhere and to be considerate of developers who do not speak our native language.
+
+Therefore: source code, comments, documentation, commit messages, review comments, and any other kind of contribution *MUST* use the English language.
+
+Typos are unavoidable, but try to reduce them by using a spellchecker. Most IDEs can be configured to run one automatically.
+
+## Code Guidelines
+
+To contribute to the project, you need to have the [pre-commit tool](https://pre-commit.com/) installed on your machine to check code style and formatting.
+
+1. To check if pre-commit is installed, you must successfully run the following command:
+
+```shell
+$ pre-commit --version
+```
+pre-commit 2.17.0
+
+2. After pre-commit is installed on your machine, within the SDK project folder, you must run the following command to set up the git hook scripts of the project:
+
+```shell
+$ pre-commit install
+```
+
+After that, git hooks will run automatically before every commit command.
+
+In general, be conscious when contributing and try to follow the same style that the code in the SDK already has. If you have any doubts, just ask us!
+
+These rules will be enforced automatically when making a pull request, and checks will fail if you do not follow them, resulting in your contribution being automatically rejected until fixed.
+
+## Comment Guidelines
+
+Comments in code are a hard thing to write, not because the words are difficult to produce but because it is hard to make relevant comments. Too much of it, and people do not read comments (and it obfuscates code reading), and too little of it gives you no recourse but to read large portions of the codebase to understand what a feature/code block is doing. Both situations are undesirable, and efforts should be made at all times to have a pleasant comment reading experience.
+
+As a general rule, you would have to comment on decisions you made while coding that are not part of any specification.
+
+In particular, you should always comment on any decision that:
+
+* Departs from common wisdom or convention (The **why's** are necessary).
+* Takes a significant amount of time to produce. A good rule of thumb here is that if you spent more than 1 hour thinking about how to produce a fragment of code that took 2 minutes of wrist time to write, you should document your thinking to aid the reader and allow for validation.
+* Needs to preserve properties of the implementation. This is the case of performance-sensitive portions of the codebase, goroutines synchronization, implementations of security primitives, congestion control algorithms, etc.
+
+As a general rule of what not to comment, you should avoid:
+
+* Commenting on the structure of programs that is already part of a convention, specified or otherwise.
+* Having pedantic explanations of behavior that can be found by immediate examination of the surrounding code artifacts.
+* Commenting on behavior you cannot attest.
+
+### Branching Guidelines
+
+Currently, `main` is our only long-term branch. Below are a few suggestions for short-term branch names:
+
+* `hotfix/something-needs-fix`: Small routine patches in code for an existing feature.
+* `feature/something-new`: A new feature or a change in an existing feature. Beware of breaking changes that would require a major version bump.
+* `doc/improves-documentation-for-this-feature`: If you add or change documentation with no impact on the source code.
+
+### Git Guidelines
+
+All commits **SHOULD** follow the [seven rules of a great Git commit message](https://chris.beams.io/posts/git-commit):
+
+1. Separate subject from body with a blank line.
+2. Limit the subject line to 72 characters.
+3. Capitalize the subject line.
+4. Do not end the subject line with a period.
+5. Use the imperative mood in the subject line.
+6. Wrap the body at 72 characters.
+7. Use the body to explain what and why vs. how.
+
+Commits such as "fix tests", "now it's working", and many other common messages we usually find in code **WON'T** be accepted.
+
+Ideally, we would like to enforce these rules, but we are realistic and understand that it might be a big change for some people. So, unless deviating heavily from what was stated, we might accept your commits even if not following these rules perfectly.
+
+Please avoid taking too much time to deliver code and always [rebase](https://git-scm.com/docs/git-rebase) your code to avoid reverse merge commits.

README.md

@@ -1,4 +1,111 @@
-# sdk-go
-Mercado Pago's official Go SDK.
+# Mercado Pago SDK for Go
 
-This library is a work in progress.
+[![Go Reference](https://pkg.go.dev/badge/github.com/mercadopago/sdk-go.svg)](https://pkg.go.dev/github.com/mercadopago/sdk-go)
+
+A comprehensive Go client library for integrating with the Mercado Pago API.
+
+## 💡 Requirements
+
+The SDK requires Go 1.x.x or higher.
+
+## 📲 Installation
+
+First time using Mercado Pago? Create your [Mercado Pago account](https://www.mercadopago.com), if you don't have one already.
+
+Install the Mercado Pago SDK for Go:
+```sh
+$ go install github.com/mercadopago/sdk-go
+```
+
+That's it! The Mercado Pago SDK for Go has been successfully installed.
+
+## 🌟 Getting Started
+
+Simple usage looks like:
+
+```go
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/mercadopago/sdk-go/pkg/config"
+	"github.com/mercadopago/sdk-go/pkg/payment"
+)
+
+func main() {
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	req := payment.Request{
+		TransactionAmount: 105.1,
+		Payer: &payment.PayerRequest{
+			Email: "{{EMAIL}}",
+		},
+		Token:        "{{CARD_TOKEN}}",
+		Installments: 1,
+	}
+
+	client := payment.NewClient(cfg)
+	pay, err := client.Create(context.Background(), req)
+	if err != nil {
+		fmt.Println(err)
+		return
+	}
+
+	fmt.Println(pay)
+}
+```
+
+### SDK Configuration
+
+Before making API requests, you need to initialize the SDK with your access token:
+
+```go
+	accessToken := "{{ACCESS_TOKEN}}"
+
+	cfg, err := config.New(accessToken)
+```
+
+### Making API Requests
+
+To make requests to the Mercado Pago APIs, you can use the packages provided by the SDK. For example, to list payment methods, you can use the `paymentmethod` package:
+
+```go
+	client := paymentmethod.NewClient(cfg)
+	paymentMethods, err := client.List(context.Background())
+```
+
+### Exception throwing handling
+
+Every package methods returns two variables: response (type of the package) and error (type of the std lib), which will contain any error thrown. It is important to handle these errors in the best possible way.
+```go
+	paymentMethods, err := client.List(context.Background())
+	if err != nil {
+		// appropriate treatment
+	}
+```
+
+For more details on the available methods and request parameters, please refer to the [Go Reference](https://pkg.go.dev/github.com/mercadopago/sdk-go) documentation.
+
+## 📚 Documentation
+
+See our documentation for more details.
+
+- Mercado Pago API Reference: [English](https://www.mercadopago.com/developers/en/guides) | [Portuguese](https://www.mercadopago.com/developers/pt/guides) | [Spanish](https://www.mercadopago.com/developers/es/guides)
+
+## 🤝 Contributing
+
+All contributions are welcome, ranging from people wanting to triage issues, others wanting to write documentation, to people wanting to contribute with code.
+
+Please read and follow our [contribution guidelines](CONTRIBUTING.md). Contributions not following these guidelines will be disregarded. The guidelines are in place to make all of our lives easier and make contribution a consistent process for everyone.
+
+## ❤️ Support
+
+If you require technical support, please contact our support team at our developers site: [English](https://www.mercadopago.com/developers/en/support/center/contact) | [Portuguese](https://www.mercadopago.com/developers/pt/support/center/contact) | [Spanish](https://www.mercadopago.com/developers/es/support/center/contact)