2014-07-14 12 views
7

W swoich exploitach do skryptów często sprawdzam, czy skrypt został napisany wcześniej, zanim zacznę od zera. Często mogę znaleźć przynajmniej to, czego potrzebuję, przez Google lub w inny sposób. Następnie dostosowuję to, co znajduję do moich potrzeb i wprowadzam do produkcji. Najlepszą praktyką jest komentowanie mojego kodu i dołączanie informacji o autorze (nie jestem fanem plagiatu). Pojawia się jednak pytanie, w jaki sposób i kiedy należy dodać/zmienić to oznaczenie autora. Użyję przykładowy skrypt z Ed Wilson poza swoim blogu dla odniesienia:Jaki jest właściwy sposób udostępniania środków na tworzenie i edytowanie skryptów?

Function Get-OutlookCalendar { 
    <# 
    .Synopsis 
    This function returns appointment items from default Outlook profile 
    .Description 
    This function returns appointment items from default Outlook profile. It 
    uses the Outlook interop assembly to use the olFolderCalendar enumeration. 
    It creates a custom object consisting of Subject, Start, Duration, Location 
    for each appointment item. 
    .Example 
    Get-OutlookCalendar | 
    where-object { $_.start -gt [datetime]"5/10/2011" -AND $_.start -lt ` 
    [datetime]"5/17/2011" } | sort-object Duration 
    Displays subject, start, duration and location for all appointments that 
    occur between 5/10/11 and 5/17/11 and sorts by duration of the appointment. 
    The sort is shortest appointment on top. 
    .Notes 
    NAME: Get-OutlookCalendar 
    AUTHOR: ed wilson, msft 
    LASTEDIT: 05/10/2011 08:36:42 
    KEYWORDS: Microsoft Outlook, Office 
    HSG: HSG-05-24-2011 
    .Link 
    Http://www.ScriptingGuys.com/blog 
    #Requires -Version 2.0 
    #> 

    Add-Type -AssemblyName "Microsoft.Office.Interop.Outlook" | Out-Null 
    $olFolders = "Microsoft.Office.Interop.Outlook.OlDefaultFolders" -as [type] 
    $outlook = New-Object -ComObject Outlook.Application 
    $namespace = $outlook.GetNameSpace("MAPI") 
    $folder = $namespace.getDefaultFolder($olFolders::olFolderCalendar) 
    $folder.items | 
     Select-Object -Property Subject,Start,Duration,Location 
} 

wyświetlić polu Autor jako punkt kontaktowy dla tego scenariusza, jak jest to osoba, która napisała go i rozumie je. Czy istnieje ogólna reguła, jak zmienia się scenariusz, zanim nie ma już sensu wymieniać oryginalnego autora? Czy oni zawsze są autorami, a następnie jesteś redaktorem?

W przypadku tego ostatniego, jaki jest odpowiedni sposób na wskazanie tego? Czy dodajesz wiersz pod Autorem oznaczonym "Redaktorem" i zmieniasz ostatnią etykietę edycji? Jak dokładnie jest właściwy sposób dokumentowania swoich wkładów? Czy istnieje udokumentowana najlepsza praktyka?

Odpowiedz

9

ja generalnie mają siebie jako autora i to moje (pracy) informacje kontaktowe, skoro, jak komentarze są do spożycia wewnętrznego, i byłbym najbardziej przydatnym punktem kontaktu dla każdego, kto czyta komentarze.

Generalnie również umieszczam tam pole lub fragment "zaadaptowany z", w którym wymienię gdzie i od kogo przechwyciłem dowolne fragmenty kodu. To o wiele mniej na temat plagiatu (ci ludzie udostępnili swój kod online za darmo, oni oczekują odosób, aby go skopiować) i wiele więcej informacji o tym, czy będą mogli ponownie znaleźć zasoby, jeśli zajdzie taka potrzeba. Moi szefowie nie troszczą się nawet o "kredyt" dla skryptów - mógłbym napisać to od zera lub skopiować - makaron całą całość, o ile to działa ... i podejrzewam, że to samo dotyczy większości ludzi w IT .

+0

Prawie przez cały czas, gdy łapię kod z .net, umieszczę blurb na górze z linkiem do oryginału wraz z oryginalnym nazwiskiem autora. Potem opiszę to, co zmieniłem, jeśli tylko z dokładnie tych samych powodów. – NotMe

3

Zakładając, że masz prawo do korzystania z kodu za to, co masz zamiar używać go i spełniający wszystkie/jakichkolwiek praw i ograniczeń ....

Musisz zrozumieć, że dla siebie i docelowi odbiorcy. Jeśli chodzi o coś, co pracujesz jako sysadmin w twojej firmie, kogo to obchodzi? Uważasz siebie i źródło (źródła), nie ma znaczenia, kto jest autorem i kto jest redaktorem.

Jeśli chodzi o coś rozprowadzane wśród klientów/świata, to prawdopodobnie powinieneś być głównym kontaktem, jeśli ktoś ma pytania dotyczące pomocy technicznej, ponieważ ma znaczenie, jak to działa w kontekście, w którym został rozpowszechniony.

Jeśli chodzi o autora-a-redaktora, to dość ograniczający sposób patrzenia na to. Pomyśl o czymś takim jak jądro Linuksa - Linux Torvalds jest oryginalnym autorem, ale jest wielu ludzi, którzy wnieśli swój wkład.

(głosowałem, aby przejść do SO, ponieważ jest to naprawdę kwestia programowania.)

+1

To nie jest dobre pytanie, ponieważ jest oparte na opiniach. –

+2

Cóż, to nie jest świetne pytanie na temat SF: – mfinni

+0

Fotografuję głównie w celu uzyskania najlepszej praktyki, czegoś udokumentowanego gdzieś mówiąc, że to jest standard ... Zaktualizowałem moje pytanie, aby odzwierciedlić bardziej szczegółową, nie opartą na opiniach odpowiedź. Szukam. – Colyn1337

Powiązane problemy