Warning: Can't synchronize with repository "(default)" (/home/git/ome.git does not appear to be a Git repository.). Look in the Trac log for more information.
Notice: In order to edit this ticket you need to be either: a Product Owner, The owner or the reporter of the ticket, or, in case of a Task not yet assigned, a team_member"

Task #2101 (closed)

Opened 12 years ago

Closed 6 years ago

Bug: Copy all documentation from ome.api.* to omero.api.*

Reported by: jamoore Owned by:
Priority: critical Milestone: Testing2
Component: API Version: 4.4.8
Keywords: n.a. Cc: jburel, rleigh, sbesson
Resources: n.a. Referenced By: n.a.
References: n.a. Remaining Time: 0.0d
Sprint: n.a.

Description (last modified by jmoore)

Also be sure to update the OmeroDevelopment page with tips & rules for how to document.

Change History (17)

comment:1 Changed 12 years ago by jmoore

  • Description modified (diff)

comment:2 Changed 12 years ago by jmoore

  • Cc ajpatterson jburel added

comment:3 Changed 12 years ago by jmoore

  • Sprint 2010-04-02 (6) deleted

comment:4 Changed 11 years ago by jmoore

  • Owner set to jmoore
  • Sprint set to 2010-06-10 (11)

comment:5 Changed 11 years ago by jburel

  • Sprint changed from 2010-06-10 (11) to 2010-06-24 (12)

comment:6 Changed 11 years ago by jmoore

  • Component changed from API to Documentation
  • Milestone changed from OMERO-Beta4.2 to Unscheduled
  • Priority changed from minor to major
  • Sprint 2010-06-24 (12) deleted

Pushing to unscheduled. Just too many things to do.

comment:7 Changed 11 years ago by bwzloranger

Brian: So Josh what tasks should I add to on ticketing these? What do you see as the goal? improving commentary on javaDocs? Site navigation changes? Do you have something in mind or just an overall review?

Josh Moore: There's already a ticket for moving all docs from ome.api.* to omero.api.*
Then a general overview of each of those methods. Has anything changed? Are there tests to show that the method does what the docs say. Then there need to be a small handful of landing pages. When you go to any of those sites, you're somewhat at a loss for where to get started.

comment:8 Changed 10 years ago by jmoore

  • Milestone changed from Unscheduled to OMERO-Beta4.4
  • Owner jmoore deleted
  • Priority changed from major to critical
  • Summary changed from Copy all documentation from ome.api.* to omero.api.* to Bug: Copy all documentation from ome.api.* to omero.api.*

See also #4341 (delete documentation): there it is difficult to point users from ome.api.IUpdate to the proper location because it is not in ome.api.IDelete but only omero.api.IDelete. It is definitely time to make the move!

comment:9 Changed 10 years ago by jmoore

  • Milestone changed from OMERO-Beta4.4 to OMERO-Beta4.4.1

Don't see us getting to this for the main release. Pushing to 4.4.1 as one of these post-release documentation tickets. If we'd rather have a 4.4.0-DOC milestone, I'm fine with that, too.

comment:10 Changed 9 years ago by jmoore

  • Cc rleigh bpindelski sbesson added

Expanding CC for a discussion while we tackle the rest of the docs.

comment:11 Changed 9 years ago by hflynn

Is this ticket still valid now we have the sphinx docs?

comment:12 Changed 9 years ago by jamoore

  • Component changed from Documentation to API

Moving this out of the Documentation component. This requires changes to components/blitz/resources/omero/api/*

comment:13 Changed 8 years ago by jamoore

  • Milestone changed from OMERO-4.4.9 to Testing2
  • Version set to 4.4.8

Pushing yet again, unfortunately. This time moving it to milestone:Testing2 which covers "integration, refactoring, coverage". Perhaps we can handle it there?

comment:14 Changed 8 years ago by jamoore

See also #11763

comment:15 Changed 6 years ago by sbesson

At the moment the omero.api.* pages link to the corresponding ome.api.* via latest redirects. Is this sufficient or do we want to bite the bullet and do the full copy. If so, that might be something we can do as part of OMERO 5.3.0.

comment:16 Changed 6 years ago by jamoore

  • Cc cxallan ajpatterson bpindelski removed

The ome.api unfortunately doesn't map 1-1 meaning users will be confused and subtly mislead.

comment:17 Changed 6 years ago by sbesson

  • Remaining Time changed from 0.5 to 0
  • Resolution set to duplicate
  • Status changed from new to closed
Note: See TracTickets for help on using tickets. You may also have a look at Agilo extensions to the ticket.

1.3.13-PRO © 2008-2011 Agilo Software all rights reserved (this page was served in: 0.90141 sec.)

We're Hiring!