Skip to content

x/tools/godoc: Dockerize and convert to run on GAE Flex #27205

Closed
@andybons

Description

@andybons

godoc relies on https://golang.org/doc/go1.10#goroot but GAE Classic is still running Go 1.9.

Convert to use GAE Flex so that we can rid ourselves of these limitations (and deploy godoc from the release-branch.go1.11)

/cc @bradfitz @dmitshur @katiehockman

Activity

added
NeedsFixThe path to resolution is known, but the work has not been done.
SoonThis needs action soon. (recent regressions, service outages, unusual time-sensitive situations)
on Aug 24, 2018
added this to the Unreleased milestone on Aug 24, 2018
self-assigned this
on Aug 24, 2018
bradfitz

bradfitz commented on Aug 24, 2018

@bradfitz
Contributor

Milestone: Go 1.6 :)

bradfitz

bradfitz commented on Aug 24, 2018

@bradfitz
Contributor

Also, because we're using a Go 1.10 x/tools on golang.org now, certain links don't work from the release notes & blog post, like:

https://golang.org/cmd/go/#hdr-Modules__module_versions__and_more

Because the godoc heading rules. This should be a heading:

Modules, module versions, and more

But it renders as a plain paragraph at the moment.

dmitshur

dmitshur commented on Aug 24, 2018

@dmitshur
Member

Similarly, this statement from https://golang.org/doc/go1.11#godoc is not yet true on https://golang.org/pkg/:

The godoc web server now shows which version of Go introduced new API features.

As a workaround, in the meantime, you can refer to https://tip.golang.org/pkg/. E.g.:

https://tip.golang.org/pkg/os/#UserCacheDir

steren

steren commented on Aug 30, 2018

@steren

FYI, Go 1.11 on the App Engine standard environment is coming.

53 remaining items

dmitshur

dmitshur commented on Jan 30, 2019

@dmitshur
Member

The task described in the original issue has long been complete. This issue has remained opened because there was one remaining clean up task (see #27205 (comment)):

  • remove build tag from main.go (i.e., merge appinit.go and main.go)

The work happening in #29206 obsoletes the need for this to be done. /cc @cnoellekb After the golang.org website is deployed from x/website, x/tools/cmd/godoc will be reduced in scope to just serve documentation locally, and its appinit.go will be simply deleted.

That work is better tracked by other open issues, so I'll close this as done.

agnivade

agnivade commented on Jan 30, 2019

@agnivade
Contributor

There were a few others also which weren't done.

  • remove zipping from build process (generate-index.bash)
    ability to add shortlinks (old app had a login, GAE Flex doesn't have authed handlers)

Not sure if they would be obsoleted too.

dmitshur

dmitshur commented on Jan 30, 2019

@dmitshur
Member

Thanks for pointing that out, I didn't see those two.

  • remove zipping from build process (generate-index.bash)

I think this one will either be obsolete or will naturally come up as part of the post-move cleanup process. I don't see a need to track it via a dedicated issue, but if someone wants to, feel free to open one. Edit: This opportunity is now captured in an open issue at #29206 (comment).

  • ability to add shortlinks (old app had a login, GAE Flex doesn't have authed handlers)

I was going to open a new issue for that. I saw that https://golang.org/s pointed to this issue, but didn't find that task which related for it. Opened #29988 to track this.

gopherbot

gopherbot commented on Jan 30, 2019

@gopherbot
Contributor

Change https://golang.org/cl/160377 mentions this issue: godoc/short: point to new tracking issue for shortlink creation

gopherbot

gopherbot commented on Jan 30, 2019

@gopherbot
Contributor

Change https://golang.org/cl/160477 mentions this issue: [release-branch.go1.11] godoc/short: point to new tracking issue for shortlink creation

locked and limited conversation to collaborators on Jan 30, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    FrozenDueToAgeNeedsFixThe path to resolution is known, but the work has not been done.

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

      Development

      No branches or pull requests

        Participants

        @bradfitz@broady@steren@andybons@agnivade

        Issue actions

          x/tools/godoc: Dockerize and convert to run on GAE Flex · Issue #27205 · golang/go