Page Comparison

...

When creating a new document with $Documents.New, it will be in the "Draft" state, until you use a method to save it. However, Document.Save( ) will save the new document in a repository, not in a specific folder (it will be in a system, but not shown anywhere). If you want to save the new document to be able to access it from a specific folder, seeDocument.Publish.In conclusion, this method is better when used for changes made on an already existing documents, and for saving the new documents, you should refer to theDocument.Publish.

Example

var doc = $Documents.New('My Document');
doc.Files.AddPDF('<p>Hello</p>', 'report.pdf'); // content of a document
doc.Publish(["myfolder", "otherfolder"]); // folders in which the document will be published (this is very important for saving a new document)

doc.Title = 'Sample Document'; // making some changes on an existing document
doc.Save(); // saving the changes (only after the document is already published)

...