2014-07-14 6 views
7

In meinen Skript-Exploits überprüfe ich oft, ob ein Skript bereits geschrieben wurde, bevor ich von vorne anfange. Oft kann ich etwas von dem, was ich brauche, durch Google oder andere Mittel finden. Ich passe dann das, was ich finde, an meine Bedürfnisse an und setze es in Produktion. Als Best Practice kommentierte ich meinen Code und fügte Autoreninformationen hinzu (ich bin kein Fan von Plagiaten). Allerdings stellt sich die Frage, wie und wann es angebracht ist, diese Autorenbezeichnung hinzuzufügen/zu ändern. Ich werde ein Beispielskript von Ed Wilson aus seinem Blog als Referenz verwenden:Was ist der richtige Weg, um Credits für Skripterstellung und -bearbeitung zu teilen?

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 
} 

Ich sehe den Autor Feld als Ansprechpartner für das Skript, wie es die Person, die es geschrieben ist und es versteht. Gibt es eine allgemeine Faustregel, wie stark ein Skript geändert wird, bevor es nicht mehr sinnvoll ist, den ursprünglichen Autor aufzulisten? Oder sind sie immer der Autor und dann sind Sie ein Redakteur?

Im letzteren Fall, was ist die geeignete Art, das zu bezeichnen? Fügen Sie unter Author mit der Bezeichnung "Editor" eine Zeile hinzu und ändern Sie die letzte Bearbeitungsbezeichnung? Wie genau ist der richtige Weg, um Ihre Beiträge zu dokumentieren? Gibt es eine dokumentierte Best Practice?

Antwort

9

Ich habe mich im Allgemeinen als Autor und umfassen meine (Arbeit) Kontaktinformationen, da, wie Kommentare für den Eigenverbrauch sind, und ich wäre der nützlichste Ansprechpartner für jeden, der die Kommentare liest.

Ich auch im Allgemeinen ein "angepasst von" Feld oder Abschnitt dort, wo ich auflisten, wo und von wem ich schnappte Codeschnipsel. Es ist viel weniger über Plagiate (diese Leute haben ihren Code kostenlos online zur Verfügung gestellt, sie erwarten Leute, um es zu kopieren) und viel mehr über die Fähigkeit, die Ressourcen wieder zu finden, wenn nötig. Meine Chefs kümmern sich nicht einmal ein bisschen um "Kredit" für Skripte - ich könnte es von Grund auf neu schreiben oder die ganze Sache kopieren, solange es funktioniert ... und ich vermute, das gleiche gilt für die meisten Leute in der IT .

+0

So ziemlich jedes Mal, wenn ich Code von der .net nehme ich einen Klappentext an der Spitze mit einem Link zum Original zusammen mit dem ursprünglichen Autorenname. Dann werde ich eine kurze Beschreibung dessen geben, was ich geändert habe, wenn auch aus genau den gleichen Gründen. – NotMe

3

Unter der Annahme, dass Sie den Code für verwenden dürfen, was Sie beabsichtigen, es zu benutzen für und mit allen/Gesetzen und Beschränkungen zu beachten ....

Sie werden feststellen, dass Sie selbst herausfinden müssen und die beabsichtigte Zielgruppe. Wenn es für etwas ist, das Sie als Systemadministrator in Ihrer Firma ausführen, wen interessiert das? Sie schreiben sich selbst und die Quelle (n), egal wer der Autor und wer der Herausgeber ist.

Für etwas, das an Kunden/die Welt verteilt wird, sollten Sie wahrscheinlich der Hauptansprechpartner sein, wenn jemand Supportfragen hat, da es wichtig ist, wie es in dem Kontext funktioniert, in dem Sie es verteilt haben.

In Bezug auf Autor-vs-Editor, das ist eine ziemlich einschränkende Art, es zu betrachten. Denken Sie an etwas wie den Linux-Kernel - Linux Torvalds ist der ursprüngliche Autor, aber es gibt eine Menge Leute, die beigetragen haben.

(I gestimmt SO zu bewegen, weil das ist wirklich eine Frage der Programmierung ist.)

+1

Es ist keine gute [so] Frage, weil es auf Meinungen basiert. –

+2

Nun, es ist nicht eine große Frage SF entweder – mfinni

+0

Ich fotografiere in erster Linie für eine Best Practice, etwas dokumentiert irgendwo sagen, das ist der Standard ... Ich habe meine Frage aktualisiert, um die spezifischere, nicht-Meinung basierte Antwort ich widerspiegeln suche ich. – Colyn1337

Verwandte Themen