1. Bitbucket
  2. Public Issue Tracker
  3. master
  4. Issues

Issues

Issue #5655 open

Repository description does not appear in overview page (BB-13535)

Vinay Sajip
created an issue

When you fork a repository for a specific reason, you put the reason for the fork in the description field in the Admin page for the repository. For example, I forked vinay.sajip/django from django/django-hg-git, I did it to provide a Python 3 port of Django. That work is now done, and while I will keep this repository around for a while (it contains some changes which didn't make it into Django upstream), I have updated the description to reflect that I'm not updating this repository any more. However, that information is not available through the UI, AFAICT, so users might still fork the repo thinking it's in active use. In fact, I just got a notification of a fork today.

Comments (19)

  1. Marcus Bertrand staff

    We currently only show the description in search results. We are in the process of updating the user profile page so that repositories listed for a user include the description.

    I think editing the README would be a good place to note the reason for your fork.

  2. Vinay Sajip reporter

    I think editing the README would be a good place to note the reason for your fork.

    Won't any changes made there show up in pull requests? It increases the noise factor for upstream. Is there a good reason that you can't show the repository admin description in the overview page? If it's a screen real estate issue, you could consider making it visible in a tooltip-style pop-up when you hover over some part of the page.

  3. Patrick O'Keeffe

    I've always been puzzled why I should invest the effort to fill out a 'description' field which is never shown to users.... well, I just tried searching and the resulting presentation with descriptions is great. How much longer before user profiles have descriptions too? That will be quite nice.

    We are in the process of updating the user profile page so that repositories listed for a user include the description. [Dec 2012]

    Vinay Sajip is right though: I can't think of a single good reason the box on the Overview page containing Last Updated, Language, and Access Level should not also contain the project's description -- it currently has a nice blank area to fill. A one sentence description and README file serve different purposes.

  4. Vinay Sajip reporter

    A one sentence description and README file serve different purposes.

    Right - the README's scope is more general - the project as a whole (i.e. potentially the same across forks), whereas the description is for one specific repository only (it could be copied to a newly-created fork, but not synced if changed in either repository afterwards).

  5. kopytmyk NA

    Why then did I bother writing a long description of my fork, and then it disappeared?! I want that other people may see the description of THIS fork. I also want to see other people's fork desriptions. Maybe forking is not necessary. How the h... I would know what each of 125 forks are?!!!

  6. Michael Sheehan

    Marcus Bertrand Can you look into this again? The description is already in the HTML: <meta name="og:description" content="Hello World"/> It's pretty ridiculous to not have a way to view this on a repo's overview when you have all the other screen clutter.

  7. Julian Brunner

    I share the opinions expressed here. It seems quite weird to me to have a description field that looks like it's one of the most basic pieces of metadata for my repository, but which then ends up not being shown anywhere except in search results.

  8. Dag Ågren

    As it is, the overview page shows neither the name or the description of a project. This makes it incredibly cryptic, and not at all useful as a landing page for projects. Not all my projects have or need READMEs, and I would really prefer if the overview page actually said what it is talking about. As it is, it's nonsense.

  9. Sietse Brouwer

    This would be a great USP over Github: "On Bitbucket, you can see at a glance which fork you need, because they have descriptions." Repositories currently have an info panel at the top of their overview page: <div id=repo-info>, it looks like the below. Would it be possible to add the description to that panel?

    Last updated:    33 minutes ago
    Fork of:    selinc/guestrepo 
    Language:    Python 
    Access level:    Admin 
    

    Link to an overview page with the info panel on top: https://bitbucket.org/sietsebb/guestrepo

  10. Roman Starkov

    README is not a great substitute for what description does. Could you please show it prominently on the Overview page? Maybe even make the README warning less prominent if the project has a Description.

  11. Anton Samsonov

    It is year 2017 already out there, yet such a trivial feature of displaying repo's description still does not seem to be implemented. That is definitely above and beyond, very appealing!

  12. Log in to comment