From owner-freebsd-arch@FreeBSD.ORG Sun Nov 9 15:27:24 2014 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id BC56D2EE for ; Sun, 9 Nov 2014 15:27:24 +0000 (UTC) Received: from mail-yh0-x22b.google.com (mail-yh0-x22b.google.com [IPv6:2607:f8b0:4002:c01::22b]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 7943B39D for ; Sun, 9 Nov 2014 15:27:24 +0000 (UTC) Received: by mail-yh0-f43.google.com with SMTP id a41so1438998yho.30 for ; Sun, 09 Nov 2014 07:27:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:date:message-id:subject:from:to:content-type; bh=OpSNI+fhcjTp2QoT0EoRzMnyR4UZsU4T1cegouJfi1g=; b=Y3ohH3Lrgh+oGd8xPeuIWFG155TPOCSgomBB2X2E+ZWzxNjZm79QF5Qo1GGLkOygTH +mzK0fZhFhqSuZhsEBBPA2C6fOUVLzXASwa7RNrQYZhO1VKuQRalslb5m97gBwWMMYuO bhXwePt7uZxeCzKDI6q7M0jAX6EkFtloF3X5FrGbWS3UNEs+qqSIi/yPRicxFW7qUkzX fQoVptg/ESfDeDm83EneFEL8hhjO/pSwjekyUgOtVXiKM15DxNlryKQf6msJ5+Mmt5PT Vcd6F25AIlWhsRDWis8fKrzXs4BdmHXEUDIMMrtfILPVJ3FxMk/dnOhwqQFY+F6BAsIt l0Dw== MIME-Version: 1.0 X-Received: by 10.236.30.227 with SMTP id k63mr24374032yha.28.1415546843295; Sun, 09 Nov 2014 07:27:23 -0800 (PST) Received: by 10.170.84.133 with HTTP; Sun, 9 Nov 2014 07:27:23 -0800 (PST) Date: Sun, 9 Nov 2014 07:27:23 -0800 Message-ID: Subject: Lack of informative files in FreeBSD svn From: Mehmet Erol Sanliturk To: FreeBSD Arch Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.18-1 X-BeenThere: freebsd-arch@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Discussion related to FreeBSD architecture List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 09 Nov 2014 15:27:24 -0000 Dears All , When the FreeBSD svn is studied , one of the most important problems seems to be missing ReadMe or other informative files in many directories . The assumption at present seems to be that such a study will ALWAYS be performed by persons who know the FreeBSD very well . This structure is , in my opinion , an important obstacle in front of the persons wishing to study and understand the FreeBSD structure very well and then try to make contributions . As an example , consider https://svnweb.freebsd.org/base/user/ directory . In that directory , there are work in progress projects ( I assume like that ) . There is a guidelines text , but not a ReadMe file or any other named file to list names and their project subjects . Also there is no any html file which contains links to related off site pages such as FreeBSD wiki . And also no one of the directories contain a ReadMe file about the tasks studied . It may be said that , no one of the directory is related to the general public other than its owner . Such an idea is very contrary to ideas specified in status reports and open projects pages and in some other messages that saying there is an important man power requirement . Another disadvantage is that when a person wishes to make an improvement she/he is not able to study existing works and if possible to join to such groups . There remains a possibility , mostly , to start from scratch in isolation. Many points are documented in FreeBSD wiki . In the svn , I did not see any html file that presents links to such pages ( there may exist some but seems that they are very rare ) . I am sorry to be very negative , but I think there is no any other choice to explain above ideas . For example , I am studying https://svnweb.freebsd.org/base/head/contrib/expat/ In it , there is a directory https://svnweb.freebsd.org/base/head/contrib/expat/tests/ it contains https://svnweb.freebsd.org/base/head/contrib/expat/tests/README.txt?view=markup but it does not contain any link to information how to use new kyua testing facility for these tests . It may be said that "You should know !" , but my problem is "How ?" . I do NOT expect that all of the directories can be populated with such informative files immediately . In some very distant places , there may be many informative pages , but how I can know where they are . It may be said "Search " , but "What ?" . My suggestion is to start such a convention with the goal that such informative files will attract more people to make contributions and also will be a good documentation about FreeBSD maintenance . Thank you very much . Mehmet Erol Sanliturk