basic_client.py and example_client.py about python-tuf HOT 5 CLOSED

On Mon Feb 11 14:10:43 2013, Vladimir Diaz wrote:

The client modules need your review.
Based on your experience integrating TUF with Seattle's software
updater and working on the interposition module(s), how is TUF's
usability? What about the code's readability? What can be improved,
other than the documentation that will updated following the
refactoring effort?

Let me get back to you about this later today.

from python-tuf.

I agree that code readability is important, but I think that TUF source code is readable enough, and we should dedicate more time to documentation, especially for users.

How about we use GitHub Pages for this?

from python-tuf.

Why not use Trac? I don't mind moving, but I'd like to know what we gain
over our existing wiki software...

Thanks,
Justin

On Tue, Feb 26, 2013 at 5:09 PM, TKK [email protected] wrote:

I agree that code readability is important, but I think that TUF source
code is readable enough, and we should dedicate more time to documentation,
especially for users.

How about we use GitHub Pages http://pages.github.com/ for this?

—
Reply to this email directly or view it on GitHubhttps://github.com/akonst/tuf/issues/15#issuecomment-14143027
.

from python-tuf.

It seems to me that at this point, the Trac repository is getting outdated, and maintaining two sources of information (Trac, GitHub) is going to be tricky. Also, wikis are not so great for documentation sometimes.

Do we really need the Trac repository anymore? How about having updateframework.com be all about documentation, and point to GitHub for all code?

from python-tuf.

Docs on updateframework.com seems good to me.

Thanks,
Justin

On Tue, Feb 26, 2013 at 5:37 PM, TKK [email protected] wrote:

It seems to me that at this point, the Trac repository is getting
outdated, and maintaining two sources of information (Trac, GitHub) is
going to be tricky. Also, wikis are not so great for documentation
sometimes.

Do we really need the Trac repository anymore? How about having
updateframework.com be all about documentation, and point to GitHub for
all code?

—
Reply to this email directly or view it on GitHubhttps://github.com/akonst/tuf/issues/15#issuecomment-14144421
.

from python-tuf.