Can not access to documentation for developers because of *404 Not Found*

Bug #1562416 reported by Shinobu KINJO
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Tricircle
Fix Released
High
Chaoyi Huang

Bug Description

Documentation for developers is expected at [1]. But that link is just broken.
So none of developers does not find out documentation to contribute the Tricircle project on top of the OpenStack project.
This issue is very trivial but it's important because it's *expected* to be there.

[1] http://docs.openstack.org/developer/tricircle

Chaoyi Huang (joehuang)
Changed in tricircle:
importance: Undecided → High
status: New → Confirmed
Revision history for this message
Chaoyi Huang (joehuang) wrote :

As the guide in OpenStack new project: http://docs.openstack.org/infra/manual/creators.html#add-link-to-your-developer-documentation only official project will be allowed to publish doc here. So we may have to remove this link in readme. How do you think about this fix?

Revision history for this message
Shinobu KINJO (shinobu) wrote :

It's fine to remove the link.
But for the future and joiners to the Tricircle project, what I would like to make sure are:

 1. What should we promote the Tricircle project to the official project?
 2. What kind of activities will be required to do that?
 3. Is there any criteria between official and non-official?

Any idea?

Revision history for this message
Shinobu KINJO (shinobu) wrote :

According to Documentation team, the Tricircle project seems to close
to be official (but not really official kind of) since we have
standard directory structure. [1]

What we need to do from here is to submit a project-config patch to
publish the documentation to [2]. Once we finish this stage, we would
have a guide underneath developer.

With this process, we're required to apply to the TC with adding your
repository to the governance repository. [3] [4] What TC will check
are described in [5].

As of now, a summary of remaining processes to join the OpenStack,

 1.Approval process by TC
 2.PTL election.

Probably still I've been missing something. If there, please point
them out to me.

BTW since we've been already done some bug fixes, it's worth noticing
and keeping it mind [6].

[1] https://git.openstack.org/cgit/openstack/tricircle/tree/
[2] http://docs.openstack.org/developer/tricircle
[3] http://docs.openstack.org/project-team-guide/open-community.html#technical-committee-and-ptl-elections
[4] http://governance.openstack.org/
[5] http://governance.openstack.org/reference/new-projects-requirements.html
[6] http://governance.openstack.org/reference/project-testing-interface.html

Revision history for this message
Shinobu KINJO (shinobu) wrote :
Revision history for this message
Shinobu KINJO (shinobu) wrote :

There is an additional work to become an official (approval) project.
Once we complete PTL election with everyone's consensus, we need to
update projects.yaml. [1]
I think that the OSPF to become approval project is to elect PTL, then
talk to other PTLs of other projects.

[1] https://github.com/openstack/governance/blob/master/reference/projects.yaml

Revision history for this message
Chaoyi Huang (joehuang) wrote :

Job to publish document to OpenStack website is addressed in https://review.openstack.org/#/c/400493/ after the Tricircle was accepted as OpenStack big-tent project

Revision history for this message
Chaoyi Huang (joehuang) wrote :

This bug was addressed, the doc could be published to OpenStack official website now: http://docs.openstack.org/developer/tricircle/

Changed in tricircle:
assignee: nobody → Chaoyi Huang (joehuang)
status: Confirmed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.