Skip to content
This repository was archived by the owner on Sep 9, 2020. It is now read-only.

Commit 64d7f61

Browse files
committed
docs: new release announcement, CSS fixes
1 parent f10e951 commit 64d7f61

File tree

4 files changed

+72
-125
lines changed

4 files changed

+72
-125
lines changed

docs/the-solver.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,9 @@ will result in an error, as `C` imports a package that will necessarily result i
6969

7070
Go 1.4 introduced [import comments](https://golang.org/cmd/go/#hdr-Import_path_checking), which allow a package to specify the import path that must be used when addressing it. For example, `import "github.com/golang/net/dict"` would point to a valid package, but because [it uses an import comment](https://github.com/golang/net/blob/42fe2e1c20de1054d3d30f82cc9fb5b41e2e3767/dict/dict.go#L7) to enforce that it must be imported as `golang.org/x/net/dict`, dep would reject any project attempting to import it directly through its github address.
7171

72-
Because most projects are consistent about their import comment use over time, this issue typically only occurs when adding a new dependency or attempting to revive an older project.
72+
Because most projects are consistent about their import comment use over time, this issue typically only occurs when adding a new dependency or attempting to revive an older project.
73+
74+
> Note: dep does not currently enforce this rule, but [it needs to](https://github.com/golang/dep/issues/902).
7375
7476
**Remediation:** change the code by fixing the offending import paths. If the offending import paths are not in the current project and you don't directly control the dependency, you'll have to fork and fix it yourself, then use `source` to point to your fork.
7577

website/blog/2018-01-23-announce-v0.4.0.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,36 @@ author: sam boyer
44
authorURL: http://twitter.com/sdboyer
55
---
66

7-
This blog post will test file name parsing issues when periods are present.
7+
v0.4.0 of dep [has been released](https://github.com/golang/dep/releases/tag/v0.4.0) - and along with it, this site for documentation and announcements about dep! And, being that it's been nearly six months since [the last dep status update](https://sdboyer.io/dep-status/2017-08-17/) (which are now officially discontinued, in favor of this blog), and the roadmap hasn't been substantially updated in even longer, we'll use this release as an excuse to bring a bunch of things up to speed.
8+
9+
### A new dep release!
10+
11+
After three months of work, the next version of dep is stable and ready for public use. The big headline changes are:
12+
13+
* `dep prune` no longer exists as a separate command. It has been absorbed into `dep ensure`, and its behavior can now be more granularly controlled by [directives in `Gopkg.toml`](https://golang.github.io/dep/docs/Gopkg.toml.html#prune). Calls to `dep prune` will not fail now, but will in future versions, so update your scripts!
14+
* Support for govendor and glock have been added; `dep init` can now read their metadata files and attempt to automatically convert projects managed by those tools.
15+
16+
Additional information is available in [the release notes](https://github.com/golang/dep/releases/tag/v0.4.0). The other major addition is this documentation site!
17+
18+
### Docs docs docs
19+
20+
Dep has had a documentation problem for a while. Having a single-command interface helped us get by with having only an FAQ, but as time wore on, it became increasingly clear that we needed a comprehensive set of documentation if people were to really feel comfortable with the tool.
21+
22+
This site, which is automatically generated from the [docs directory](https://github.com/golang/dep/tree/master/docs) within the dep repository by [docusaurus](http://docusaurus.io/), is now that comprehensive source of docs. More so than any individual bit of information, it provides some broader benefits:
23+
24+
* New user guides - reference documentation is not what folks need when starting with a new tool. Step-by-step instructions are. Now [we have that](https://golang.github.io/dep/docs/introduction.html), and it caters to users who are not only new to dep, but also to Go in general.
25+
* Thematic organization of content - up until now, we were somewhat haphazardly flinging information into the FAQ. The body of documentation here is organized from the ground up, which will hopefully make it both more useful and easier to maintain.
26+
* Versioning - all of the docs are snapshotted on each release, and users can [select the version of the docs](https://golang.github.io/dep/versions.html) they want to view. Ideally, everyone should always be able to use the latest version, but this at least means you're not penalized if that's not feasible for you/your organization.
27+
* A blog - you're reading it! This is great, as it provides us a canonical place to circulate information about what's happening with the project.
28+
29+
At the same time, the docs aren't quite comprehensive _yet_. There's more reference material and guides to be written. For example, we're still missing a guide for project maintainers on how to make releases that align well with dep's happy path.
30+
31+
Also, now that we have this whole docs apparatus, it would be particularly awesome if someone were to step up to help as a [docs maintainer](https://github.com/golang/dep/issues/629#issuecomment-359922251)! Also also, the CSS on this site is terrible, and
32+
33+
### The future
34+
35+
Right now, there's two aspects to the future of dep. One is the roadmap of changes and features that make sense for dep as it exists today, in this standalone context. The other is the roadmap for moving dep into the toolchain.
36+
37+
For the former, we have a fair bit of work underway that, now that this release is out the door, we can move on quickly. That includes major performance improvements, solver improvements to pick a sane version more of the time with less manual intervention, allowing the `source` field to work the way [most people expect it to](https://github.com/golang/dep/issues/860), and others. The goal is also to move dep towards a more regular release schedule.
38+
39+
With respect to dep's movement towards the toolchain, discussions have already been ongoing between dep folks and the Go team for months. Movement into the toolchain is not a simple process. Some rules that dep, as a standalone tool, had to accept as law, become negotiable (for example, the semantics of vendor directories). There's also the question of how to best fit dep's commands themselves into the `go` tool. These present both interesting design opportunities and considerable risk. More information and opportunities for comment will be coming as we move into the Go 1.10 cycle. As has always been the plan, though, dep will continue to exist as a standalone tool until the toolchain has evolved sufficiently to supplant it.

website/pages/en/versions.js

Lines changed: 0 additions & 88 deletions
This file was deleted.

website/static/css/custom.css

Lines changed: 36 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,45 @@
11
/* your custom css */
22

3+
.homeContainer {
4+
flex: 1 0 auto;
5+
padding-bottom: 1em;
6+
}
7+
8+
.docMainWrapper {
9+
flex: 1 0 auto;
10+
padding-bottom: 1em;
11+
}
12+
13+
.homeContainer .homeWrapper .projectLogo {
14+
justify-content: center;
15+
position: relative;
16+
padding: 2em;
17+
}
18+
19+
.homeContainer .homeWrapper .projectLogo img {
20+
max-height: 360px;
21+
}
22+
23+
body {
24+
display: flex;
25+
flex-direction: column;
26+
}
27+
28+
div.navPusher {
29+
display: flex;
30+
flex-direction: column;
31+
}
32+
33+
.footer-logo {
34+
padding-top: 1em;
35+
display: flex;
36+
justify-content: center;
37+
}
38+
339
@media only screen and (min-device-width: 360px) and (max-device-width: 736px) {
440
}
541

642
@media only screen and (min-width: 1024px) {
7-
.homeContainer {
8-
flex: 1 0 auto;
9-
padding-bottom: 1em;
10-
}
11-
12-
.docMainWrapper {
13-
flex: 1 0 auto;
14-
padding-bottom: 1em;
15-
}
16-
17-
.homeContainer .homeWrapper .projectLogo {
18-
justify-content: center;
19-
position: relative;
20-
padding: 2em;
21-
}
22-
23-
.homeContainer .homeWrapper .projectLogo img {
24-
max-height: 360px;
25-
}
26-
27-
body {
28-
display: flex;
29-
flex-direction: column;
30-
}
31-
32-
div.navPusher {
33-
display: flex;
34-
flex-direction: column;
35-
}
36-
37-
.footer-logo {
38-
padding-top: 1em;
39-
display: flex;
40-
justify-content: center;
41-
}
4243
}
4344

4445
@media only screen and (max-width: 1023px) {

0 commit comments

Comments
 (0)